Transactie terugdraaien

Geldt voor betalingen op een fysieke POS-terminal

Deze API start via de cloud een terugdraaiing van een geslaagde transactie.

Een transactie kan alleen op dezelfde dag worden teruggedraaid en alleen volledig; gedeeltelijk terugdraaien is niet toegestaan.

Gebruik voor gedeeltelijke terugdraaiingen of transacties van een eerdere dag de terugbetalings-API.

Nadat een opdracht tot terugdraaien is verzonden, toont de POS-terminal het proces en het uiteindelijke resultaat in realtime, zodat merchants en gebruikers de status direct kunnen controleren. Gebruik de API Betaling annuleren voor een stille terugdraaiing (zonder het proces op de POS-terminal weer te geven).

Controleer voordat u deze API aanroept of het POS-apparaat online en beschikbaar is, zodat de opdracht tot terugdraaien kan worden afgeleverd en verwerkt.

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

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

Methode：POST

POST gegevenstype：Json

• Parameters

Voorbeeld van een handtekening:

Parameters op volgorde samengevoegd tot een querystring in URL-stijl

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

Onderteken stringA met secret_key

De gegenereerde handtekening is:

"YOUR_SIGNATURE"

Voorbeeld van een aanvraag:

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

  }
} 

Voorbeeld van een antwoord:

{
  "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": ""} 

Aanvullende informatie:

Resultaat van het antwoord:

1. Bij een geslaagde aanvraag wordt "status": true geretourneerd.

2. Bij een mislukte aanvraag wordt "status": false geretourneerd.

We raden sterk aan zowel orderopvragingen als asynchrone meldingen te gebruiken om de betaalstatus te synchroniseren en actueel te houden.

Antwoordcodes: