API REFERENCE
Wisselkoers opvragen
Deze API vraagt wisselkoersen op.
Voordat u een FX-order aanmaakt, moet u deze API aanroepen om een koers op te halen. Maak de order vervolgens binnen 30 seconden na ontvangst van de koers aan.
Opmerkingen
Tip
Opmerkingen
Geldigheidsduur van de koers
Elke geretourneerde wisselkoers is 30 seconden geldig. Vraag de wisselkoers opnieuw op nadat deze is verlopen.Afwikkelingstermijn (Tenor)
TOD: Afwikkeling in realtime, niet beïnvloed door feestdagen.
SPOT: Afwikkeling op T+2 werkdagen. Zorg vóór de afwikkelingsdatum voor voldoende saldo op de rekening. Als de afwikkeling door onvoldoende saldo mislukt, kan op basis van het werkelijke verlies een boete in rekening worden gebracht.
- Toegang tot SPOT
U moet vooraf SPOT-afwikkeling aanvragen; hiervoor gelden kredietlimieten.
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.GetFXQuote | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| sell_currency | String | Te verkopen valuta | Verplicht |
| buy_currency | String | Te kopen valuta | Verplicht |
| currency | String | Te verkopen valuta als de valuta overeenkomt met sell_currency; anders de te kopen valuta | Verplicht |
| amount | String | Te verkopen bedrag als de valuta overeenkomt met sell_currency; anders het te kopen bedrag | Verplicht |
| tenor | String | TOD of SPOT | 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
"amount=1&buy_currency=DKK¤cy=GBP&method=v3.GetFXQuote&request_id=20304095064069023960369000g-42&sell_currency=GBP&tenor=TOD&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.GetFXQuote",
"time": 1546588959,
"data": {
"sell_currency": "GBP",
"buy_currency": "DKK",
"currency": "GBP",
"amount": "1",
"tenor": "TOD",
"request_id": "20304095064069023960369000g-42"
}
}
Voorbeeld van een antwoord:
{
"status": true,
"code": "200",
"data": {
"type": "sell",
"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,
"quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
"expiry_time": 1773824647
},
"message": "",
"response_id": "202603181703362736334439"
}
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 |
