Rota de Cancelamento
Cancelamento por erro mecânico:
Endpoint Request: /api/cancel/
O AutoTEF Slim possui um método de cancelamento automático da transação caso o autosserviço tenha algum problema mecânico.
Segue exemplos de erros mecânicos, como:
- Falta de conectividade;
- O produto não foi entregue ao portador.
{
"acquirerTransactionKey": "string",
"amount": Number
}
Descrição:
| 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. |
# 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.
Request:
{
"acquirerTransactionKey": "19030073877288",
"amount": 0.1,
"transactionType": "Credit",
"panMask": "550209******6360"
}
Response
Status 200 - OK.
Status 400 - Seguirá o retorno do autorizador.
{
"ResponseCode": "",
"ResponseReason": ""
}
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.