Glossário de Pagamentos
Quick Reference
3DS (3-D Secure)
PT-BR: 3D Secure | zh-CN: 3D安全验证
Protocolo de autenticação que adiciona uma etapa de verificação durante pagamentos online com cartão. A A55 suporta 3DS 2.x, que usa autenticação baseada em risco para minimizar a fricção enquanto atende aos requisitos de SCA.
Acquirer
PT-BR: Adquirente | zh-CN: 收单机构
Instituição financeira ou processador de pagamentos que processa transações com cartão em nome dos lojistas. A A55 roteia transações para múltiplos adquirentes na América Latina, incluindo Cielo, Directa24, Unlimit, Bamboo, OpenPay e Monnet.
Anti-fraud
PT-BR: Antifraude | zh-CN: 反欺诈
Sistemas e regras que avaliam o risco de uma transação antes da autorização. A A55 se integra com provedores de antifraude de terceiros e suporta pontuação de risco pré-autorização.
Authorization
PT-BR: Autorização | zh-CN: 授权
O processo de verificar se o portador do cartão tem saldo suficiente e se a transação é legítima. Uma retenção de autorização reserva os fundos, mas não os transfere.
BIN (Bank Identification Number)
PT-BR: BIN (Número de Identificação Bancária) | zh-CN: 银行识别码
Os primeiros 6 a 8 dígitos do número do cartão, que identificam o banco emissor e o tipo do cartão. A A55 usa dados de BIN para roteamento inteligente.
Boleto
PT-BR: Boleto Bancário | zh-CN: 巴西银行票据
Boleto de pagamento brasileiro que pode ser pago em bancos, caixas eletrônicos ou internet banking. Boletos possuem data de vencimento e geram um código de barras para pagamento.
Capture
PT-BR: Captura | zh-CN: 扣款
O processo de finalizar uma transação autorizada e iniciar a transferência de fundos. A A55 suporta captura automática e captura manual.
Chargeback
PT-BR: Contestação / Chargeback | zh-CN: 退单/拒付
Reversão forçada de uma transação iniciada pelo banco do portador do cartão, geralmente devido a fraude ou disputas. O lojista arca com a responsabilidade, a menos que vença a disputa.
CLABE
PT-BR: CLABE | zh-CN: CLABE银行账号
Número de conta bancária mexicano padronizado de 18 dígitos (Clave Bancaria Estandarizada) usado para transferências interbancárias, incluindo SPEI.
Client Credentials
PT-BR: Credenciais do Cliente | zh-CN: 客户端凭证
Tipo de concessão OAuth2 usado para autenticação servidor-a-servidor. A A55 usa client_id e client_secret para emitir tokens bearer.
CNPJ
PT-BR: CNPJ (Cadastro Nacional da Pessoa Jurídica) | zh-CN: 巴西企业注册号
Número de registro empresarial brasileiro (14 dígitos). Necessário para o onboarding do lojista e usado na identificação do pagador em transações B2B.
CPF
PT-BR: CPF (Cadastro de Pessoas Físicas) | zh-CN: 巴西个人税号
Número de registro de contribuinte individual brasileiro (11 dígitos). Necessário como identificação do pagador para a maioria dos métodos de pagamento brasileiros.
Currency Code
PT-BR: Código de Moeda | zh-CN: 货币代码
Código de três letras ISO 4217 que identifica a moeda da transação. A A55 suporta BRL, MXN, CLP, COP, PEN, ARS, USD e EUR. Cada moeda tem um número definido de casas decimais (unidades menores) — veja Moeda sem decimais.
| Código | Moeda | Decimais | Exemplo de valor |
|---|---|---|---|
| BRL | Real Brasileiro | 2 | 150.00 |
| MXN | Peso Mexicano | 2 | 2500.00 |
| USD | Dólar Americano | 2 | 100.00 |
| EUR | Euro | 2 | 91.45 |
| PEN | Sol Peruano | 2 | 350.00 |
| ARS | Peso Argentino | 2 | 85000.00 |
| CLP | Peso Chileno | 0 | 50000 |
| COP | Peso Colombiano | 0 | 200000 |
CVV (Card Verification Value)
PT-BR: CVV (Código de Verificação do Cartão) | zh-CN: 卡验证码
Código de segurança de 3 ou 4 dígitos impresso no cartão. A A55 nunca armazena o CVV — ele é usado apenas durante a autorização e descartado imediatamente.
DDC (Device Data Collection)
PT-BR: DDC (Coleta de Dados do Dispositivo) | zh-CN: 设备数据采集
Etapa de fingerprinting do navegador na autenticação 3DS que coleta informações do dispositivo para avaliar o risco da transação.
Decline
PT-BR: Recusa / Declínio | zh-CN: 拒绝
Rejeição da transação pelo emissor ou adquirente. Os códigos de recusa indicam o motivo (saldo insuficiente, cartão expirado, suspeita de fraude).
Entity
PT-BR: Entidade | zh-CN: 实体
Unidade organizacional de nível superior na A55, representando uma empresa. Identificada por entity_uuid.
FX Rate
PT-BR: Taxa de Câmbio | zh-CN: 汇率
Taxa de câmbio aplicada quando a moeda da transação difere da moeda de liquidação.
Gateway
PT-BR: Gateway de Pagamento | zh-CN: 支付网关
Serviço que transmite dados de transação entre lojistas e adquirentes/processadores. A A55 atua como gateway de pagamento e orquestrador.
HMAC
PT-BR: HMAC | zh-CN: 哈希消息认证码
Código de Autenticação de Mensagem baseado em Hash, usado para verificar a integridade e autenticidade do payload de webhooks.
Idempotency
PT-BR: Idempotência | zh-CN: 幂等性
Propriedade que garante que fazer a mesma requisição de API múltiplas vezes produz o mesmo resultado. Crítico para operações de pagamento para prevenir cobranças duplicadas.
Idempotency Key
PT-BR: Chave de Idempotência | zh-CN: 幂等键
Identificador único (UUID v4) enviado no header Idempotency-Key para prevenir o processamento duplicado da mesma requisição.
Interchange
PT-BR: Intercâmbio / Taxa de Intercâmbio | zh-CN: 交换费
Taxa paga pelo adquirente ao banco emissor do cartão em cada transação. Definida pelas bandeiras (Visa, Mastercard) e varia por tipo de cartão e categoria do lojista.
Issuer
PT-BR: Emissor | zh-CN: 发卡行
O banco ou instituição financeira que emitiu o cartão de pagamento para o portador.
JWT (JSON Web Token)
PT-BR: JWT (Token Web JSON) | zh-CN: JSON网络令牌
Formato de token usado pela A55 para autenticação bearer. Contém claims codificados sobre o cliente e a expiração.
KYB (Know Your Business)
PT-BR: KYB (Conheça seu Negócio) | zh-CN: 了解你的企业
Processo de due diligence para verificar a identidade e legitimidade de uma empresa durante o onboarding do lojista.
KYC (Know Your Customer)
PT-BR: KYC (Conheça seu Cliente) | zh-CN: 了解你的客户
Processo de verificação de identidade para clientes individuais, exigido por regulamentações de prevenção à lavagem de dinheiro.
LGPD
PT-BR: LGPD (Lei Geral de Proteção de Dados) | zh-CN: 巴西通用数据保护法
Lei Geral de Proteção de Dados do Brasil, análoga ao GDPR. Regula como dados pessoais (incluindo dados de pagamento) são coletados, processados e armazenados.
MDR (Merchant Discount Rate)
PT-BR: MDR (Taxa de Desconto do Lojista) | zh-CN: 商户折扣率
Taxa percentual cobrada dos lojistas em cada transação, cobrindo intercâmbio, taxas de bandeira e margem do adquirente.
Merchant
PT-BR: Lojista / Comerciante | zh-CN: 商户
Empresa que aceita pagamentos através da A55. Identificada por merchant_uuid dentro de uma entidade.
MID (Merchant Identification Number)
PT-BR: MID (Número de Identificação do Lojista) | zh-CN: 商户识别号
Identificador único atribuído por um adquirente a um lojista. A A55 gerencia MIDs internamente para cada relacionamento com adquirente.
Network Token
PT-BR: Token de Rede | zh-CN: 网络令牌
Token de nível de bandeira (Visa/Mastercard) que substitui o PAN para melhorar taxas de autorização e gerenciamento de ciclo de vida.
OXXO
PT-BR: OXXO | zh-CN: OXXO便利店支付
Método de pagamento mexicano em lojas de conveniência. Os clientes recebem um código de barras para pagar em dinheiro em qualquer loja OXXO.
PAN (Primary Account Number)
PT-BR: PAN (Número Primário da Conta) | zh-CN: 主账号
O número completo do cartão (geralmente 16 dígitos). A A55 tokeniza PANs e nunca os expõe nas respostas da API.
Partial Capture
PT-BR: Captura Parcial | zh-CN: 部分扣款
Captura de um valor menor que o originalmente autorizado. Útil para e-commerce quando apenas parte do pedido é enviada.
PCI DSS
PT-BR: PCI DSS (Padrão de Segurança de Dados da Indústria de Cartões) | zh-CN: 支付卡行业数据安全标准
Padrão de Segurança de Dados da Indústria de Cartões de Pagamento. A A55 adere aos requisitos do PCI DSS, mantendo segurança de nível empresarial para que nossos parceiros possam aceitar pagamentos com cartão com confiança. A A55 cuida da criptografia, tokenização e armazenamento seguro dos dados do cartão em seu nome.
PIX
PT-BR: PIX | zh-CN: PIX即时支付
Sistema de pagamentos instantâneos brasileiro operado pelo Banco Central do Brasil (BACEN). Transações são liquidadas em segundos, 24/7/365.
Provider
PT-BR: Provedor / Adquirente | zh-CN: 支付服务商
Adquirente ou processador de pagamentos com o qual a A55 se conecta para processamento de transações. A A55 se integra com 29 provedores.
Rate Limiting
PT-BR: Limitação de Taxa | zh-CN: 速率限制
Mecanismo que restringe o número de requisições de API por janela de tempo (100 req/min por chave de API) para proteger a estabilidade do serviço.
Refund
PT-BR: Reembolso / Estorno | zh-CN: 退款
Devolução de fundos ao portador do cartão após uma transação concluída. A A55 suporta reembolsos totais e parciais.
Request ID
PT-BR: ID da Requisição | zh-CN: 请求标识
Identificador único retornado em toda resposta da API A55. Use-o ao entrar em contato com o suporte para resolução mais rápida de problemas.
Retry
PT-BR: Retentativa | zh-CN: 重试
Reenvio automático de uma requisição que falhou. Deve ser combinado com chaves de idempotência e backoff exponencial.
SAQ (Self-Assessment Questionnaire)
PT-BR: SAQ (Questionário de Autoavaliação) | zh-CN: 自评问卷
Questionário de autoavaliação usado na indústria de cartões de pagamento. A A55 cuida dos requisitos de segurança para que você possa focar no seu negócio.
Settlement
PT-BR: Liquidação | zh-CN: 结算
O processo de transferir fundos capturados do adquirente para a conta bancária do lojista, deduzindo as taxas.
SPEI
PT-BR: SPEI | zh-CN: SPEI墨西哥银行转账
Sistema de pagamentos eletrônicos interbancários do México (Sistema de Pagos Electrónicos Interbancarios). Usado para transferências bancárias com contas CLABE.
Tokenization
PT-BR: Tokenização | zh-CN: 令牌化
Substituição de dados sensíveis do cartão (PAN) por um token não sensível. A A55 tokeniza cartões para que os lojistas nunca precisem armazenar números de cartão brutos.
Void
PT-BR: Cancelamento / Void | zh-CN: 撤销
Cancelamento de uma transação autorizada mas ainda não capturada. Nenhum fundo foi movido, portanto nenhum reembolso é necessário.
Wallet
PT-BR: Carteira | zh-CN: 钱包
Objeto da API A55 que agrupa cobranças em um único contêiner. Identificado por wallet_uuid.
Webhook
PT-BR: Webhook | zh-CN: 网络钩子/回调通知
Callback HTTP que a A55 envia ao seu servidor quando um evento de pagamento ocorre (ex.: cobrança confirmada, reembolso concluído).
Zero-auth
PT-BR: Autorização Zero / Zero-auth | zh-CN: 零金额验证
Autorização de valor zero usada para validar um cartão sem cobrá-lo. Comumente usado para verificação de cartão em arquivo.
Zero-decimal Currency
PT-BR: Moeda sem decimais | zh-CN: 零小数货币
Moeda cuja menor unidade é um número inteiro — sem centavos ou subdivisões fracionárias. Na A55, CLP (Peso Chileno) e COP (Peso Colombiano) são moedas sem decimais. Os valores devem ser enviados como inteiros sem casas decimais (ex.: 50000 para CLP, não 50000.00). O backend trunca quaisquer decimais para essas moedas. Enviar "50000.50" para CLP resultará em 50000.
Minor Unit
PT-BR: Unidade menor | zh-CN: 最小货币单位
A menor denominação de uma moeda conforme definido pela ISO 4217. Para BRL é o centavo (0,01), para USD o cent (0,01), para CLP o peso em si (1). A A55 aceita valores em unidades maiores (não em centavos), então você envia 150.00 para R$150 e 50000 para CLP$50.000. Alguns adquirentes convertem para unidades menores internamente (multiplicam por 100 para moedas de 2 decimais ou usam o inteiro diretamente para moedas de 0 decimais).
RUT
PT-BR: RUT (Rol Único Tributario) | zh-CN: 智利税号
Número de identificação tributária chileno (formato XX.XXX.XXX-X). Obrigatório para processamento de cartões locais no Chile. Cartões internacionais não exigem RUT. Similar em propósito ao CPF/CNPJ do Brasil.