API REFERENCE
Consulter un ordre de change
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.trade_id | string | 询价的id | ✓ |
| data.request_id | string | 请求id需保持唯一，建议24以上位数字+字母 | ✓ |
Cette API consulte les informations d’un ordre de change.
Après la création et l’exécution d’un ordre de change, utilisez cette API pour consulter son dernier statut, les informations d’exécution et les transactions associées.
Veuillez utiliser un compte dédié.
user=040268
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | UID au niveau du marchand | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.QueryFXOrder | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:--- |:--- | | trade_id | String | ID de cotation | Obligatoire | | request_id | String | ID de requête unique ; une combinaison d’au moins 24 chiffres et lettres est recommandée | Obligatoire |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"method=v3.QueryFXOrder&request_id=20304095064069023960369q-11&time=1546588959&trade_id=6e5cf660fb58455cd68a413a8249061a&user=040268"
Signer stringA avec secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête :
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.QueryFXOrder",
"time": 1546588959,
"data": {
"trade_id": "6e5cf660fb58455cd68a413a8249061a",
"request_id": "20304095064069023960369q-11"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"booking_status": "success",
"settlement_status": "settled",
"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": "202603181711118835985708"
}
Informations complémentaires :
Résultat de la réponse :
- Si l’appel réussit, "status": true est renvoyé.
- Si l’appel échoue, "status": false est renvoyé.
Codes de réponse :
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The user not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
booking_status
| Status | Description |
|---|---|
| success | La demande de réservation de change a été traitée avec succès et l’ordre a été créé ou exécuté. |
| failed | La demande a échoué en raison d’une erreur interne du système. Réessayez plus tard ou contactez le support technique si le problème persiste. |
| pending | La demande est en attente, car la vérification de la signature a échoué. Vérifiez les paramètres de signature et réessayez. |
| reversed | La demande n’a pas pu être traitée, car l’utilisateur indiqué n’existe pas dans le système. |
| rolled | La demande a été rejetée, car un ou plusieurs champs obligatoires sont absents des paramètres. |
| updated | L’ID de requête fourni est incorrect ou ne correspond à aucune transaction existante. |
settlement_status :
| Status | Description |
|---|---|
| open | L’ordre de change a été créé avec succès et attend son règlement. |
| settled | La transaction de change a été entièrement réglée et les fonds ont été livrés selon la durée convenue. |
| pending | L’ordre de change a été créé, mais le règlement n’est pas encore terminé. Cela peut se produire en attendant la date de règlement (par exemple, SPOT T+2). |
| cancelled | L’ordre de change a été annulé et ne sera pas réglé. |