API REFERENCE
trade_id abrufen
Rufen Sie trade_id mit invoice_id ab.
Tipp
Verwenden Sie nach einer erfolgreichen Transaktion diese API, um das zugehörige
trade_idfür nachfolgende Vorgänge abzurufen, z. B. für eine Erhöhung oder Verringerung der Autorisierung, Capture, Abfrage, Stornierung oder Rückerstattung.
API-URL (Produktion): https://mapi.yabandpay.com/Payments
API-URL (Test): https://acc-mapi.yabandpay.com/Payments
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonto UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.GetTradeId | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| invoice_id | String | Bestellnummer | Erforderlich |
Signaturbeispiel:
Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.
"invoice_id=1234567&method=v3.GetTradeId&time=1546588959&user=YOUR_CASHIER_UID"
Signieren Sie stringA mit secret_key.
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetTradeId",
"time": 1546588959,
"data": {
"invoice_id": "1234567"
}
}
Antwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"trade_id": "2312e8b0-8ed5-6a66-293e-29efc206c599"
},
"message": ""
}
Weitere Informationen:
Antwortergebnis:
-
Bei erfolgreichem Aufruf wird "status": true zurückgegeben.
-
Bei fehlgeschlagenem Aufruf wird "status": false zurückgegeben.
Antwortcodes:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -4006 | Order number does not exist |
Hinweise
trade_id ist üblicherweise etwa 1 Minute nach Abschluss der Transaktion verfügbar.
Wird der Fehler „Bestellnummer ist nicht vorhanden“ zurückgegeben, warten Sie etwa 1 Minute und versuchen Sie es erneut.
