Rota de cancelamento com Split de pagamento.
Cancelamento por erro mecânico:
Endpoint Request: /api/cancel/
O AutoTEF Slim possibilita o cancelamento automático da transação caso o terminal de Autoatendimento tenha algum problema mecânico.
Segue exemplos de erros mecânicos, como:
- Queda de luz;
- Terminal foi desplugado no meio da transação;
- A internet local destravou;
- O produto não foi entregue ao portador.
Exemplo de valor:
{
"acquirerTransactionKey": "string",
"amount": 0,
"splits": [
{
"amount": Number,
"splitType": string,
"recipientIdentification": "string",
"chargeProcessingFee": Boolean,
"chargeRemainderFee": Boolean,
"liable": Boolean
}
]
}
| Campo | Definição |
|---|---|
| acquirerTransactionKey | ATK = É o código de autorização gerado pela Stone, tanto para transações aprovadas, como para transações negadas. Este é o valor que será referência para identificar uma transação na Stone. Também é conhecido como StoneID ou NSU Host |
| Amount | Valor da transação. |
| SplitRequest.RecipientIdentification | Código do recebedor. Formato: rp_XXXXXXXXXXXXXXXX. |
| SplitRequest.changeProcessingFee* | Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação |
| SplitResquest.liable* | Indica se o recebedor é responsável pela transação em caso de chargeback. |
IMPORTANTE !!!
O ambiente de homologação Stone não tem suporte para o split, os testes deverão ser feitos no Piloto.
Sabendo que no ambiente pagar.me só teremos transações de débito e crédito, Pagar.me ainda não tem voucher.
Cancelamento no PDV:
Esse método será utilizado quando o Slim for implementado para ser utilizado em um PDV. Com esse método o operador de caixa conseguirá utilizar o PINPAD para realizar o cancelamento em sua máquina.
{
"acquirerTransactionKey": "19030073877288",
"amount": 0.1,
"transactionType": "Credit",
"panMask": "550209******6360",
"splits": [
{
"amount": Number,
"splitType": string,
"recipientIdentification": "string",
"chargeProcessingFee": Boolean,
"chargeRemainderFee": Boolean,
"liable": Boolean
}
]
}
Response
Status 200 - OK.
Status 400 - Seguirá o retorno do autorizador.
Status 500 - First call the activate router or check connections in endpoint.
{
"message": "First call the activate router or check connections in endpoint 'api/Healthcheck'.",
"statusCode":500
}
| Campo | Definição |
|---|---|
| transactionType | é o tipo de transação que foi utilizado para realizar a compra. Exemplo: Debit ou Credit. |
| panMask | Nesse campo serve para ser informado o valor do Pan Mascarado do cartão do cliente, que foi utilizado na transação. Esse valor é importante para o AutoTEF validar se a transação que está sendo cancelada, está sendo feita com mesmo cartão que foi utilizado na origem da transação. |
Importante armazenar nos bancos de dados:
Como você precisando dos dados do "panMask" e do ATK da transação, vocês tem que guarda em seu banco os dados da transação aprovada e do PAN mascarado do cartão do cliente que foi feita a transação, para chamar o PinPad no cancelamento.