Gere recibos

Aprenda a gerar recibos para transações.

Quando você faz uma transação usando a API de Terminais, a resposta inclui dados de recibo. Ela contém valores que você pode adicionar ao recibo que você imprimir, exibir em tela ou enviar por e-mail ao seu cliente.

Se o seu terminal tiver uma impressora embutida, como o V400m e V400c, o recibo será impresso automaticamente utilizando as informações da transação. Opcionalmente, você pode adicionar o seu logotipo ao recibo.

Requisitos para os recibos

As bandeiras têm requisitos muito específicos sobre o que deve ser incluído em um recibo. Esses requisitos diferem por esquema e país, e estes podem mudar. Os recibos gerados pela Adyen foram certificados como compatíveis com os esquemas de cartões que utilizamos.

As bandeiras visitam ocasionalmente as lojas para verificar se os recibos gerados são totalmente compatíveis com os requisitos.

Para evitar não conformidade e estornos evitáveis, é altamente recomendável usar os recibos gerados pela Adyen sem alterações. Se você substituir esses dados de recebimento ou validar valores com relação a uma lista codificada, é de sua responsabilidade garantir que os requisitos do esquema sejam atendidos o tempo todo.

Dados do recibo

Quando você faz um pagamento usando nossa API de Terminais, o resultado do pagamento contem um objeto PaymentReceipt. Este objeto contem:

CustomerReceipt: Você pode usar esses dados para gerar um recibo para o cliente.
CashierReceipt: Você pode usar esses dados para gerar um recibo de comerciante. Você pode usar isso para coletar a assinatura do cliente ou para fins de reconciliação.

Cada recebimento consiste em múltiplos pares de valores-chave, gerados dinamicamente, dependendo do:

Tipo de transação.
Resultado (por exemplo, aprovado ou recusado).
Método de verificação do titular do cartão (CVM - Cardholder verification method).
País emissor do cartão.
País da sua loja.
Forma de pagamento.

Abaixo estão todas as chaves possíveis que podem aparecer nos dados de recebimento gerados pela Adyen:	Chave	Descrição
`header1`	Primeira linha do cabeçalho do seu recibo. Você pode personalizar isso.
`header2`	Segunda linha do cabeçalho do seu recibo. Você pode personalizar isso.
`aac`	Recusar o criptograma gerado pelo cartão.
`accountType`	Conta bancária usada para a autorização. Por exemplo, conta corrente ou conta poupança.
`additionalEmvData`	Conjunto de detalhes EMV.
`aid`	Identificador de aplicativo (o produto da bandeira).
`approved`	Estado final para transações aprovadas.
`refused`	Estado final para transações recusadas.
`void`	Estado final para transações que foram canceladas pelo comerciante, comprador ou terminal.
`atc`	Contador de transações das aplicações.
`authCode`	Authorization code from the issuer.
`authResponseCode`	Código de autorização do emissor.
`buyerId`	Identificação da carteira usada para autorização.
`cardholderHeader`	Indicador de tipo de recibo. Por exemplo, VIA DO CLIENTE (ou o texto localizado).
`cardType`	Valor determinado pelo terminal para o tipo de cartão.
`cashbackAmount`	Valor a ser fornecido ao comprador em dinheiro.
`charityAmount`	Valor doado para a caridade pelo comprador.
`cid`	Dados de informações de criptograma.
`cnpj`	Número de identificação emitido para o Registro Nacional de Pessoas Jurídicas.
`currentBalanceAmount`	Saldo na conta bancária do titular do cartão.
`cvmRes`	Quando aplicável, indica que o PIN foi verificado.
`dccexpl`	Explicação do processo DCC, para consentimento do comprador.
`dccmarkup`	Marcação da margem do DCC.
`dccrate`	Taxa de câmbio usada para calcular a conversão do DCC (incluindo a margem).
`dccshopperamount`	Valor após a conversão do DCC foi aplicado.
`dccsource`	Fonte da taxa de câmbio base (procurada por Adyen, exclue a margem).
`discountAmount`	Desconto aplicado pelo comerciante.
`expiryDate`	Data de validade do cartão.
`filler`	Preenchimento genérico para criar blocos de elementos que vão juntos.
`gratuityAmount`	Valor da gratuidade.
`mid`	Identificação do comerciante.
`mref`	Referência determinada pelo comerciante para a transação.
`originalAmount`	Valor inicial da transação antes da gratificação, ajustes e outros.
`pan`	Os últimos quatro dígitos do PAN (número do cartão) mascarado.
`panSeq`	Número de sequência PAN (número do cartão) ou número de sequência do cartão emitido.
`paymentMethod`	Método de pagamento no nível da marca ou esquema, conforme fornecido pela Adyen. Por exemplo `visa`, `maestro`.
`paymentMethodVariant`	Método de pagamento no nível do produto, conforme fornecido pela Adyen. Por exemplo, `visastandarddebit`, `vpay`.
`posEntryMode`	Método de obtenção do PAN (número do cartão), como ICC, NFC, MSR ou MKE.
`preferredName`	Etiqueta determinada pelo emissor para a aplicação no cartão.
`productType`	Produto usado para pagamento, como Crédito ou Débito.
`ptid`	Identificador de hardware (terminal) enviado as bandeiras.
`retain`	Mensagem de retenção.
`rrn`	Número de referência de recuperação.
`stan`	Número de auditoria de rastreamento do sistema.
`tid`	Identificador de terminal Adyen.
`tokenTxVariant`	Descrição da variante de token, como ApplePay ou SamsungPay.
`totalAmount`	Valor total a ser debitado ou creditado.
`txdate`	Data do terminal da transação, no fuso horário local.
`txRef`	Referência para a transação, fornecida pelo comerciante.
`txtime`	Hora terminal da transação, no fuso horário local.
`txtype`	Tipo de transação: COMPRA_DE_MERCADORIA, REEMBOLSO e assim por diante.
`walletDccAmount`	Valor após a aplicação do DCC pela bandiera.
`walletDccRate`	Taxa aplicada pela bandeira para calcular o DCC.
`walletOperationType`	Semelhante a `paymentMethod`. Por exemplo, `alipay` ou `wechatpay`.
`walletTransactionReference`	Referência que a bandeira atribuído à transação.
`sigline`	A linha para indicar que uma assinatura precisa ser colocada acima dela.
`signature`	Espaço para assinatura do comprador no recibo do comerciante.
`merchantSigline`	Linha para assinatura do comerciante no recibo do comprador.
`thanks`	Mensagem de agradecimento (ou o texto localizado).
`QRCode`	Valor QR code. Você pode personalizar isso.

Exibindo recibos virtuais

Se você estiver usando um terminal multimída com tela grande, como o M400, você poderá exibir itens em linha ou recibos na tela do terminal.

Para mais informações, consulte Exibir dados no terminal.

Próximas etapas

obrigatório

Fundamentos da API de terminais

Conheça nossa API de terminais.

Customize recibos

Adicione um logotipo e altere o QR code e as linhas de cabeçalho nos recibos.

Exibir notificações

Mantenha sua equipe informada sobre os eventos das transações

Notificações de eventos

Mantenha sua equipe informada sobre eventos fora do fluxo de pagamento.