As características de uma transação de débito são:
- Envie o
Payment.Type
como "DebitCard";- Envie o nó
Payment.DebitCard
;- O nó
Payment.FraudAnalysis
não deve ser informado, pois a transação não necessita de análise de fraude;- É obrigatório submeter a transação de débito à autenticação. Por isso, envie o nó
Payment.ExternalAuthentication
com os dados recebidos durante o processo de autenticação 3DS 2.2. Para saber mais sobre a integração 3DS 2.2, acesse o Manual de Autenticação 3DS 2.2.
Requisição
post https://apisandbox.braspag.com.br/v2/sales
{
"merchantorderid": "30082019",
"customer": {
"Name": "Comprador Accept",
"email": "[email protected]",
"Identity": "18160361106",
"identitytype": "CPF",
"Mobile": "5521995760078"
},
"payment": {
"Provider": "Simulado",
"type": "Debitcard",
"DoSplit": "True",
"amount": 10000,
"capture": true,
"installments": 1,
"softdescriptor": "teste",
"ReturnUrl": "https://www.UrlDeRetornoDoLojista.com.br/",
"DebitCard": {
"cardNumber": "4481530710186111",
"holder": "Yamilet Taylor",
"ExpirationDate": "12/2019",
"SecurityCode": "693",
"Brand": "Visa",
"SaveCard": "false"
},
"ExternalAuthentication":{
"Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Eci":"5",
"Version":"2",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
},
"splitpayments": [
{
"subordinatemerchantid": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"amount": 5000,
"fares": {
"mdr": 5,
"fee": 30
}
},
{
"subordinatemerchantid": "9140ca78-3955-44a5-bd44-793370afef94",
"amount": 5000,
"fares": {
"mdr": 4,
"fee": 15
}
}
]
}
}
A seguir, veja as propriedades de campo nesta requisição:
Propriedade | Descrição | Tipo/Tamanho | Obrigatório |
---|---|---|---|
Payment.Authenticate | Define se o comprador será direcionado ao emissor para autenticação do cartão. | Booleano ("true" / "false") | Sim, caso a autenticação seja validada. |
Payment.ExternalAuthentication.ReturnUrl | URL de retorno aplicável somente se a versão for "1". | Alfanumérico / 1024 posições | Sim. |
Payment.ExternalAuthentication.Cavv | Assinatura retornada nos cenários de sucesso na autenticação. | Texto | Sim, caso a autenticação seja validada. |
Payment.ExternalAuthentication.Xid | XID retornado no processo de autenticação. | Texto | Sim, quando a versão do 3DS for "1". |
Payment.ExternalAuthentication.Eci | Electronic Commerce Indicator retornado no processo de autenticação. | Numérico / 1 posição | Sim. |
Payment.ExternalAuthentication.Version | Versão do 3DS utilizado no processo de autenticação. | Alfanumérico / 1 posição | Sim, quando a versão do 3DS for "2". |
Payment.ExternalAuthentication.ReferenceID | RequestID retornado no processo de autenticação. | GUID / 36 posições | Sim, quando a versão do 3DS for "2". |
Resposta
{
"MerchantOrderId": "30082019",
"Customer": {
"Name": "Comprador Accept",
"Identity": "18160361106",
"IdentityType": "CPF",
"Email": "[email protected]",
"Mobile": "5521995760078"
},
"Payment": {
"DebitCard": {
"CardNumber": "448153******6111",
"Holder": "Yamilet Taylor",
"ExpirationDate": "12/2019",
"SaveCard": false,
"Brand": "Visa"
},
"Authenticate": true,
"ExternalAuthentication":{
"Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Eci":"5",
"Version":"2",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
},
"ReturnUrl": "https://www.UrlDeRetornoDoLojista.com.br/",
"ProofOfSale": "439387",
"AcquirerTransactionId": "0830110439387",
"SoftDescriptor": "teste",
"DoSplit": true,
"SplitPayments": [
{
"SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 5000,
"Fares": {
"Mdr": 5.0,
"Fee": 30
},
"Splits": [
{
"MerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 4720
},
{
"MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
"Amount": 280
}
]
},
{
"SubordinateMerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
"Amount": 5000,
"Fares": {
"Mdr": 4.0,
"Fee": 15
},
"Splits": [
{
"MerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
"Amount": 4785
},
{
"MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
"Amount": 215
}
]
}
],
"PaymentId": "5bb92d7c-4f3e-40dc-9f83-bd09c02fea38",
"Type": "DebitCard",
"Amount": 10000,
"ReceivedDate": "2019-08-30 11:04:33",
"Currency": "BRL",
"Country": "BRA",
"Provider": "Simulado",
"ReasonCode": 9,
"ReasonMessage": "Waiting",
"Status": 0,
"ProviderReturnCode": "1",
"Links": [
{
"Method": "GET",
"Rel": "self",
"Href": "https://apiquerysandbox.braspag.com.br/v2/sales/5bb92d7c-4f3e-40dc-9f83-bd09c02fea38"
},
{
"Method": "PUT",
"Rel": "void",
"Href": "https://apisandbox.braspag.com.br/v2/sales/5bb92d7c-4f3e-40dc-9f83-bd09c02fea38/void"
}
]
}
}