API REFERENCE
EPS
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.pay_method | string | online | ✓ |
| data.sub_pay_method | string | EPS | ✓ |
| data.order_id | string | 商户的订单ID | ✓ |
| data.amount | string | 金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1 | ✓ |
| data.currency | string | EUR | ✓ |
| data.description | string | 订单描述 | ✓ |
| data.demo | string | 自定义字段 | — |
| data.timeout | string | 过期时间单位分钟(0-1440) | ✓ |
| data.redirect_url | string | 支付完成后跳转地址 | — |
| data.notify_url | string | 支付完成后异步通知地址 | ✓ |
EPS est un système de virement en ligne développé conjointement par les banques autrichiennes et le gouvernement. Il s’agit d’un moyen de paiement par virement bancaire majeur en Autriche, très apprécié des consommateurs autrichiens. Lorsqu’ils choisissent EPS au moment du paiement, les clients sont redirigés vers la banque en ligne de leur établissement, où ils autorisent le paiement via l’interface bancaire en ligne et les protocoles de sécurité de leur banque. Les fonds sont transférés depuis leur compte bancaire, le paiement est traité en temps réel et le client comme le marchand reçoivent immédiatement une confirmation du paiement.
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | Compte caissier UID | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.CreatePayments | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:----------------------------------|:--- | | pay_method | String | online | Obligatoire | | sub_pay_method | String | EPS | Obligatoire | | order_id | String | ID de commande du marchand | Obligatoire | | amount | String | Montant numérique. Par exemple, € 24.99 doit être indiqué comme 24.99 ; le montant minimum en euros est >=1 | Obligatoire | | currency | String | EUR | Obligatoire | | description | String | Description de la commande | Obligatoire | | demo | String | Champ personnalisé | Facultatif | | timeout | String | Délai d’expiration en minutes (0-1440) | Obligatoire | | redirect_url | String | URL de redirection après la finalisation du paiement | Facultatif | | notify_url | String | URL de notification asynchrone après la finalisation du paiement | Obligatoire |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"amount=1¤cy=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments¬ify_url=https://www.yabandpay.com/notify&order_id=202508271641&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=EPS&time=1646388458&timeout=0&user=YOUR_CASHIER_UID"
Signer stringA avec secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête :
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.CreatePayments",
"time": 1646388458,
"data": {
"description": "YabandPay test",
"timeout":"0",
"pay_method": "online",
"sub_pay_method": "EPS",
"order_id": "YOUR_ORDER_ID",
"amount": "1",
"currency": "EUR",
"redirect_url": "https://www.yabandpay.com",
"notify_url": "https://www.yabandpay.com/notify",
"demo": "test"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"order_id": "YOUR_ORDER_ID",
"trade_id": "c9a8217a-69d2-8338-c065-d24947aabd5a",
"amount": "1.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/pay_method/ZXBz/YzlhODIxN2EtNjlkMi04MzM4LWMwNjUtZDI0OTQ3YWFiZDVh",
"state": "processing"
},
"message": ""
}
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.
Nous recommandons vivement d’utiliser à la fois Consultation de commande et Notifications asynchrones afin de maintenir des statuts de paiement exacts et à jour.
Codes de réponse :
| Status | Code | Message |
|---|---|---|
| true | 200 | Success |
| false | -1000 | Internal error |
| false | -3001 | Required field is missing |
| false | -403 | The signature Error |
| false | -4011 | Not support the payment method |
