Documentatie/API-referentie

API REFERENCE

Een valutawisselorder aanmaken

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Een valutawisselorder aanmaken

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters4

Required fields first

创建换汇订单

order_idRequiredstringdata.order_id外汇订单id
quote_idRequiredstringdata.quote_id询价的id
request_idRequiredstringdata.request_id请求id需保持唯一,建议24以上位数字+字母
Optional parameters 1
referenceOptionalstringdata.reference备注

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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

ParameterTypeBeschrijvingVerplicht
userStringMerchantniveau UIDVerplicht
signStringSignatureVerplicht
methodStringv3.ExecuteFXOrderVerplicht
timeLongTimestampVerplicht
  • Parameters
ParameterTypeBeschrijvingVerplicht
order_idStringFX-order-IDVerplicht
quote_idStringKoers-IDVerplicht
request_idStringUnieke aanvraag-ID; een combinatie van minimaal 24 cijfers en letters wordt aanbevolenVerplicht
referenceStringRemarksOptioneel

Voorbeeld van een handtekening:

Parameters op volgorde samengevoegd tot een querystring in URL-stijl

"method=v3.ExecuteFXOrder&order_id=202603051019-16&quote_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:
  1. Bij een geslaagde aanroep wordt "status": true geretourneerd.
  2. Bij een mislukte aanroep wordt "status": false geretourneerd.
Antwoordcodes:
StatusCodeBericht
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID