Dokumentation/API-Referenz

API REFERENCE

FX-Auftrag erstellen

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

FX-Auftrag erstellen

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.

Diese API erstellt einen FX-Auftrag.

Nachdem Sie den Wechselkurs abgefragt haben, müssen Sie den FX-Auftrag mit dem zurückgegebenen quote_id innerhalb von 30 Sekunden ausführen.

Tipp

Nachdem Sie quote_id erhalten haben, reichen Sie den FX-Auftrag innerhalb von 30 Sekunden ein und führen Sie ihn aus.

Läuft der Kurs ab, rufen Sie die API zur Wechselkursabfrage erneut auf, um einen neuen Kurs zu erhalten.

Verwenden Sie bitte ein dediziertes Konto.

user=040268

ParameterTypBeschreibungErforderlich
userStringHändlerbezogenes UIDErforderlich
signStringSignatureErforderlich
methodStringv3.ExecuteFXOrderErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
order_idStringFX-Auftrags-IDErforderlich
quote_idStringKurs-IDErforderlich
request_idStringEindeutige Anfrage-ID; empfohlen wird eine Kombination aus mindestens 24 Ziffern und BuchstabenErforderlich
referenceStringRemarksOptional

Signaturbeispiel:

Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.

"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"

Signieren Sie stringA mit secret_key.

Die resultierende Signatur lautet:

"YOUR_SIGNATURE"

Anfragebeispiel:

{
  "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"
  }
}

Antwortbeispiel:

{
  "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"
}

Weitere Informationen:

Antwortergebnis:
  1. Bei erfolgreichem Aufruf wird "status": true zurückgegeben.
  2. Bei fehlgeschlagenem Aufruf wird "status": false zurückgegeben.
Antwortcodes:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID