Reversão da transação

Aplica-se a pagamentos presenciais com POS

Esta API inicia a reversão de transações bem-sucedidas pela nuvem.

A reversão de transação só é compatível com transações do dia atual e permite apenas reversões totais.

Para reversões parciais ou transações de dias anteriores, use a API de reembolso.

Depois que uma instrução de reversão é enviada, o terminal POS mostra em tempo real o processo e o resultado final, para que o estabelecimento e os usuários possam confirmar imediatamente o status da reversão. Para fazer uma reversão silenciosa (sem exibir o processo no terminal POS), use a API Cancel Payment.

Antes de chamar esta API, confirme que o dispositivo POS está online e disponível para que a instrução de reversão possa ser entregue e processada com sucesso.

API URL (produção): https://mapi.yabandpay.com/Payments

API URL (teste): https://acc-mapi.yabandpay.com/Payments

• Parameters

Signature example:

Parâmetros ordenados concatenados em uma cadeia de consulta no formato de URL

 "method=v3.POSReversal&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&tid=T125119061&time=1555498137&trade_id=4a49ffb3-a30f-ba92-9422-1969afb6f121&user=T125119061" 

Sign stringA using secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Request example:

 {
  "user": "T125119061",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.POSReversal",
  "time": 1555498137,
  "data": {
   "tid": "T125119061",
		"trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
    "request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"

  }
} 

Response example:

{
  "status": true,
  "code": "200",
  "data": {
        "type": "payment",
        "user": "T125119061",
        "amount": "0.10",
        "currency": "EUR",
        "trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
        "description": "YabandPay test",
        "order_id": "YOUR_ORDER_ID",
        "createDate": "1706771212",
        "demo": "test",
        "transaction_id": "",
        "state": "cancelled"
  },
  "message": ""} 

Additional information:

Response result:

1. Uma solicitação bem-sucedida retorna "status": true.
2. Uma solicitação malsucedida retorna "status": false.

Recomendamos fortemente usar tanto consultas de pedidos quanto notificações assíncronas para sincronizar e atualizar o status do pagamento e manter as informações atualizadas em tempo real.

Response codes: