API REFERENCE
CardCheck
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.pay_method | string | online | ✓ |
| data.sub_pay_method | string | CardCheck | ✓ |
| data.operation | string | 3 | ✓ |
| data.order_id | string | 商户的订单ID | ✓ |
| data.description | string | 订单描述 | ✓ |
| data.form_type | string | 返回的url类型,默认01。 01.completed, 02.iframe | — |
| data.demo | string | 自定义字段 | — |
| data.timeout | string | 过期时间单位分钟(0-1440) | ✓ |
| data.redirect_url | string | 支付完成后跳转地址 | — |
| data.notify_url | string | 支付完成后异步通知地址 | ✓ |
| data.request_id | string | 请求id需保持唯一,建议24以上位数字+字母 | ✓ |
Initiez une autorisation d’un montant de 0 pour permettre au titulaire de la carte de valider le numéro fourni. Le titulaire doit fournir des informations valides pour terminer la vérification.
La vérification peut être effectuée sur la page hébergée fournie par YabandPay. Les marchands peuvent traiter les requêtes en toute sécurité en hébergeant les données sensibles PCI DSS sur le système YabandPay.
Conseil
Récupérez le résultat de vérification via Requête de commande.
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | Compte marchand UID | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.CardCheck | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:--- |:--- | | pay_method | String | online | Obligatoire | | sub_pay_method | String | CardCheck | Obligatoire | | operation | String |3| Obligatoire| | order_id | String | ID de commande du marchand | Obligatoire | | description | String | Description de la commande | Obligatoire | | form_type | String | Type of returned url; defaults to 01. 01.completed, 02.iframe | Facultatif | | demo | String | Champ personnalisé | Facultatif | | timeout | String | Durée d’expiration en minutes (0-1440) | Obligatoire | | redirect_url | String | URL de redirection après le paiement | Facultatif | | notify_url | String | URL de notification asynchrone après le paiement | Obligatoire | | request_id | String | ID de requête unique ; une combinaison de chiffres et de lettres d’au moins 24 caractères est recommandée | Obligatoire |
Exemple de signature:
Paramètres triés et concaténés sous forme de chaîne de requête au format URL
"description=cardcheck test&form_type=01&method=v3.CardCheck¬ify_url=https://www.yabandpay.com/notify&operation=3&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=CardCheck&time=1720680417&timeout=0&user=YOUR_CASHIER_UID"
Signez la chaîne A à l’aide de secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.CardCheck",
"time": 1720680417,
"data": {
"description": "cardcheck test",
"form_type": "01",
"timeout": "0",
"pay_method": "online",
"sub_pay_method": "CardCheck",
"operation": "3",
"order_id": "YOUR_ORDER_ID",
"redirect_url": "https://www.yabandpay.com/redirect_url",
"notify_url": "https://www.yabandpay.com/notify",
"request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
}
}
Exemple de réponse:
{
"status": true,
"code": "200",
"data": {
"order_id": "YOUR_ORDER_ID",
"trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
"amount": "0.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
"state": "processing"
},
"message": "",
"response_id": "202407111544200649155078"
}
Informations complémentaires:
Résultat de la réponse:
-
Une requête réussie renvoie "status": true.
-
Une requête échouée renvoie "status": false.
Redirigez l’utilisateur vers url. Après avoir saisi ses coordonnées de carte sur cette page url et terminé le paiement, il est redirigé de manière synchrone vers redirect_url. Nous recommandons vivement d’utiliser à la fois Requête de commande and Asynchronous Notifications to synchronize and update the payment status and keep payment information accurate in real time. a) Si le statut de commande state est paid, le paiement a réussi ;
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 |
