API REFERENCE
Een valutawisselorder aanmaken
Deze API maakt een valutawisselorder aan.
Nadat u de wisselkoers hebt opgevraagd, moet u de valutawisselorder uitvoeren met de geretourneerde quote_id binnen 30 seconden.
Tip
Dien na ontvangst van quote_id de valutawisselorder binnen 30 seconden in en voer deze uit.
Is de koers verlopen, roep de API voor het opvragen van de wisselkoers dan opnieuw aan om een nieuwe koers te verkrijgen.
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.ExecuteFXOrder | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| order_id | String | FX-order-ID | Verplicht |
| quote_id | String | Koers-ID | Verplicht |
| request_id | String | Unieke aanvraag-ID; een combinatie van minimaal 24 cijfers en letters wordt aanbevolen | Verplicht |
| reference | String | Remarks | Optioneel |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"method=v3.ExecuteFXOrder&order_id=202603051019-16"e_id=83e96dc0-8f8e-48c7-9bc4-6acc1019fced&reference=YB test&request_id=203040950640690239603690g-24&time=1546588959&user=040268"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.ExecuteFXOrder",
"time": 1546588959,
"data": {
"order_id": "YOUR_ORDER_ID",
"quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
"reference": "YB test",
"request_id": "203040950640690239603690g-24"
}
}
Voorbeeld van een antwoord:
{
"status": true,
"code": "200",
"data": {
"booking_status": "pending",
"settlement_status": "pending",
"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": "202603181703581985574708"
}
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 UID not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
