Documentación/Referencia de API

API REFERENCE

Crear una orden de cambio de divesas

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

Crear una orden de cambio de divesas

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.

Parámetros

ParameterTypeDescripciónObligatorio
data.order_idstring外汇订单id✓
data.quote_idstring询价的id✓
data.request_idstring请求id需保持唯一,建议24以上位数字+字母✓
data.referencestring备注—

Esta API crea una orden de cambio de divesas.

Después de consultar el tipo de cambio, debe ejecutar la orden de cambio utilizando el valor devuelto quote_id en un plazo de 30 seconds.

Consejo

Después de obtener quote_id, envíe y ejecute la orden de cambio en un plazo de 30 seconds.

Si la cotización caduca, vuelva a llamar a la API de consulta del tipo de cambio para obtener una nueva cotización.

Utilice una cuenta específica.

user=040268

ParámetroTipoDescripciónObligatorio
userStringA nivel de comercio UIDObligatorio
signStringSignatureObligatorio
methodStringv3.ExecuteFXOrderObligatorio
timeLongTimestampObligatorio
  • Parámetros
ParámetroTipoDescripciónObligatorio
order_idStringID de la orden de cambioObligatorio
quote_idStringID de cotizaciónObligatorio
request_idStringID de solicitud único; se recomienda una combinación de al menos 24 dígitos y letrasObligatorio
referenceStringRemarksOpcional

Ejemplo de firma:

Parámetros ordenados y concatenados en una cadena de consulta con formato de URL

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

Firme la cadena A con secret_key

La firma resultante es:

"YOUR_SIGNATURE"

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

Información adicional:

Resultado de la respuesta:
  1. Si la llamada se realiza correctamente, se devuelve "status": true es returned.
  2. Si la llamada falla, se devuelve "status": false es returned.
Códigos de respuesta:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID