Pesquisar

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

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 Authorisation 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óximos passos