API REFERENCE
Een valutawisselorder opvragen
Deze API vraagt gegevens van een valutawisselorder op.
Nadat een valutawisselorder is aangemaakt en uitgevoerd, kunt u met deze API de meest recente status, uitvoeringsgegevens en bijbehorende transactiegegevens opvragen.
Gebruik een speciaal account.
user=040268
API-URL：https://mapi.yabandpay.com/Payments
Methode：POST
POST gegevenstype：Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | Merchantniveau UID | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.QueryFXOrder | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| trade_id | String | Koers-ID | Verplicht |
| request_id | String | Unieke aanvraag-ID; een combinatie van minimaal 24 cijfers en letters wordt aanbevolen | Verplicht |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"method=v3.QueryFXOrder&request_id=20304095064069023960369q-11&time=1546588959&trade_id=6e5cf660fb58455cd68a413a8249061a&user=040268"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.QueryFXOrder",
"time": 1546588959,
"data": {
"trade_id": "6e5cf660fb58455cd68a413a8249061a",
"request_id": "20304095064069023960369q-11"
}
}
Voorbeeld van een antwoord:
{
"status": true,
"code": "200",
"data": {
"booking_status": "success",
"settlement_status": "settled",
"sell_currency": "GBP",
"buy_currency": "DKK",
"sold_currency": "GBP",
"sold_amount": "1.00",
"bought_currency": "DKK",
"bought_amount": "8.54",
"tenor": "TOD",
"exchange_rate": "8.544924729",
"order_id": "YOUR_ORDER_ID",
"quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
"trade_id": "6e5cf660fb58455cd68a413a8249061a",
"reference": "YB test"
},
"message": "",
"response_id": "202603181711118835985708"
}
Aanvullende informatie:
Resultaat van het antwoord:
- Bij een geslaagde aanroep wordt "status": true geretourneerd.
- Bij een mislukte aanroep wordt "status": false geretourneerd.
Antwoordcodes:
| Status | Code | Bericht |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The user not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
booking_status
| Status | Beschrijving |
|---|---|
| success | De valutaboeking is verwerkt en de order is aangemaakt of uitgevoerd. |
| failed | De aanvraag is mislukt door een interne systeemfout. Probeer het later opnieuw of neem contact op met de technische ondersteuning als het probleem aanhoudt. |
| pending | De aanvraag is in behandeling omdat de verificatie van de aanvraaghandtekening is mislukt. Controleer de handtekeningparameters en probeer het opnieuw. |
| reversed | De aanvraag kon niet worden verwerkt omdat de opgegeven gebruiker niet in het systeem bestaat. |
| rolled | De aanvraag is afgewezen omdat een of meer verplichte velden in de aanvraagparameters ontbreken. |
| updated | De opgegeven aanvraag-ID is onjuist of komt niet overeen met een bestaande transactie. |
settlement_status：
| Status | Beschrijving |
|---|---|
| open | De FX-order is aangemaakt en wacht op afwikkeling. |
| settled | De FX-transactie is volledig afgewikkeld en het geld is volgens de overeengekomen looptijd geleverd. |
| pending | De FX-order is aangemaakt, maar de afwikkeling is nog niet voltooid. Dit kan gebeuren wanneer de afwikkelingsdatum nog niet is bereikt (bijvoorbeeld SPOT T+2). |
| cancelled | De FX-order is geannuleerd en wordt niet afgewikkeld. |