Point-of-sale icon

Envie informações da aplicação

Descreve o uso da API de terminais para fornecer detalhes da aplicação, do comerciante e do integrador em dados adicionais para a Plataforma de pagamentos da Adyen

As informações da aplicação, por exemplo, informações de identificação da aplicação, sua empresa e quaisquer informações de terceiros, nos permitem analisar e solucionar problemas de pagamentos com mais eficiência e fornecer uma melhor experiência de suporte. Na API de terminais, isso é enviado em um campo SaleToAcquirerData.

Endpoint

O URL usado para enviar mensagens da API de terminais depende do seu tipo de implementação. Para obter mais informações sobre as arquiteturas disponíveis, consulte visão geral da API de terminais.

Base64 informações da aplicação

  1. Adicione os detalhes de sua aplicação, do comerciante e integrador no formato JSON:

    {
       "applicationInfo":{
          "merchantApplication":{
             "name":"Acme Adyen Connector",
             "version":"2.0.1"
          },
          "merchantDevice":{
             "os":"Windows",
             "version":"Vista Business 3.1",
             "reference":"1234"
          },
          "externalPlatform":{
             "integrator":"Retail Consultancy Corp",
             "name":"Acme Corp POS",
             "version":"1.0.2"
          }
       }
    }

    No exemplo acima, o merchantDevice reference é o posRegisterConfiguredName, por exemplo, o nome configurado para o hardware do POS.

  2. Converta esse JSON em Base64, que fornecerá uma sequência como:

    eyJhcHBsaWNhdGlvbkluZm8iOnsKICAibWVyY2hhbnRBcHBsaWNhdGlvbiI6ewog
    ICAgIm5hbWUiIDogIkFjbWUgQWR5ZW4gQ29ubmVjdG9yIiwKICAgICJ2ZXJzaW9u
    IiA6ICIyLjAuMSIKICAgIH0sCiAgIm1lcmNoYW50RGV2aWNlIjp7CiAgICAib3Mi
    IDogIldpbmRvd3MiLAogICAgInZlcnNpb24iIDogIlZpc3RhIEJ1c2luZXNzIDMu
    MSIsCiAgICAicmVmZXJlbmNlIiA6ICIxMjM0IiDigJMgcG9zcmVnaXN0ZXJjb25m
    aWd1cmVkbmFtZQogICAgfSwKICAgICJleHRlcm5hbFBsYXRmb3JtIjp7CiAgICAg
    ICJpbnRlZ3JhdG9yIiA6ICJSZXRhaWwgQ29uc3VsdGFuY3kgQ29ycCIsCiAgICAg
    ICJuYW1lIiA6ICJBY21lIENvcnAgUE9TIiwKICAgICAgInZlcnNpb24iIDogIjEu
    MC4yIgogICAgfQogIH0KfQ==
  3. Crie um PaymentRequest e passe a sequência como dados adicionais no campo SaleToAcquirerData.

Solicitação

Para uma lista de campos PaymentRequest fields, consulte Campos PaymentRequest.

Resposta

Para uma lista de campos PaymentResponse, consulte Campos PaymentResponse.

Será realizada uma tentativa de autorização e você receberá uma resposta com os seguintes campos, incluindo uma AdditionalResponse.

A AdditionalResponse também é codificada em Base64..

{  
   "SaleToPOIResponse":{  
      "PaymentResponse":{  
         "Response":{  
            "AdditionalResponse":"YXBwbGljYXRpb25MYWJlbD1NQ0RDQ0ZSJmNhcmRIb2xkZXJWZXJpZmljYXRpb25N
ZXRob2RSZXN1bHRzPTQ0MDAwMiZBSUQ9QTAwMDAwMDAwNDEwMTAwMiZhcHBsaWNh
dGlvblByZWZlcnJlZE5hbWU9bWMlMjBmJnRpZD0xMjAwMDAwMCZtZXJjaGFudFJl
ZmVyZW5jZT1DYXJkUmVtb3ZhbC1Bc2tEY2MmdGM9RjJCQ0FCRDYxNDc4QzExNyZ0
eGRhdGU9MTAtMTEtMjAxNyZwYXltZW50TWV0aG9kPW1jJnRyYW5zYWN0aW9uUmVm
ZXJlbmNlTnVtYmVyPTg1MTUxMDMxNTU5OTAzMDYmc2hvcHBlclJlZmVyZW5jZT0x
MjMxJnRyYW5zYWN0aW9uVHlwZT1HT09EU19TRVJWSUNFUyZjYXJkVHlwZT1tYyZv
ZmZsaW5lPWZhbHNlJmNhcmRTY2hlbWU9bWMmbWlkPTUxJnR4dGltZT0xMyUzYTA2
JTNhMTYmc2hvcHBlckVtYWlsPXN3YWclNDBpbGwuY29tJmNhcmRIb2xkZXJOYW1l
PVRDMDRfTUNfQXBwcm92ZWRfREND",
            "Result":"Success"
         },
         "PaymentResult":{  
            "PaymentAcquirerData":{  
               "AcquirerTransactionID":{  
                  "TransactionID":"8515103155990306",
                  "TimeStamp":"2017-11-10T12:06:16.000Z"
               },
               "MerchantID":"TestMerchantPOSRobot02",
               "AcquirerPOIID":"MX925-261078152"
            },
            "PaymentInstrumentData":{  
               "CardData":{  
                  "CardCountryCode":"840",
                  "EntryMode":[  
                     "ICC"
                  ],
                  "MaskedPan":"541333 **** 9990",
                  "PaymentBrand":"mc",
                  "SensitiveCardData":{  
                     "CardSeqNumb":"53",
                     "ExpiryDate":"0228"
                  }
               },
               "PaymentInstrumentType":"Card"
            },
            "AmountsResp":{  
               "AuthorizedAmount":300,
               "Currency":"EUR"
            }
         },
         "PaymentReceipt":[
            {
               "OutputContent":{
                  "OutputFormat":"Text",
                  "OutputText":[
                     {
                        "CharacterStyle":"Bold",
                        "EndOfLineFlag":true,
                        "Text":"key=header1&name=Adyen"
                     },
                      [...]
                     {
                        "EndOfLineFlag":true,
                        "Text":"key=filler"
                     },
                     {
                        "EndOfLineFlag":true,
                        "Text":"key=filler"
                     }
                  ]
               },
               "DocumentQualifier":"CashierReceipt"
            },
            {
               "OutputContent":{
                  "OutputFormat":"Text",
                  "OutputText":[
                     {
                        "CharacterStyle":"Bold",
                        "EndOfLineFlag":true,
                        "Text":"key=header1&name=Adyen"
                     },
                     [...]
                     {
                        "EndOfLineFlag":true,
                        "Text":"key=filler"
                     },
                     {
                        "EndOfLineFlag":true,
                        "Text":"key=thanks&name=Thank%20you"
                     }
                  ]
               },
               "DocumentQualifier":"CustomerReceipt"
            }
         ],
         "POIData":{  
            "POITransactionID":{  
               "TransactionID":"oLkO001510315576349.8515103155990306",
               "TimeStamp":"2017-11-10T12:06:16.000Z"
            }
         },
         "SaleData":{  
            "SaleTransactionID":{  
               "TransactionID":"CardRemoval-AskDcc",
               "TimeStamp":"2017-11-10T12:05:58.686Z"
            }
         }
      },
      "MessageHeader":{  
         "SaleID":"POSSystemID12345",
         "ProtocolVersion":"3.0",
         "MessageType":"Response",
         "POIID":"MX925-261078152",
         "ServiceID":"885906155",
         "MessageClass":"Service",
         "MessageCategory":"Payment"
      }
   }
}

Se você receber um erro, use nossa página cenários de erros para solucionar o problema.

Os avisos são acionados quando ocorrem erros não fatais e são retornados na resposta.