Documentation/Référence API

API REFERENCE

Signature

1. Collectez tous les paramètres de paiement

Soit M l’ensemble des données envoyées et reçues. Triez M par ordre alphabétique croissant (ordre lexicographique), puis concaténez les paramètres dans la chaîne A sous forme de paires clé-valeur au format URL (par exemple, key1=value1&key2=value2…).

Remarque :

Triez les noms des paramètres par ordre ASCII croissant (ordre lexicographique).

Les noms des paramètres sont sensibles à la casse.

Pour vérifier la signature des données renvoyées ou d’une notification push YabandPay, excluez les champs « sign » et « data » transmis des données à signer.

2. Générez stringSign à partir de stringA et de secret_key

Appliquez HMAC-SHA256 à stringA pour obtenir la valeur de signature (signValue).

Use stringA and secret_key to get stringSign, perform HMAC-SHA256 arithmetic on stringSign, thus get sign's value (signValue).

For example:

a) Collectez tous les paramètres de paiement
array(13) {
  ["description"] => string(27) "YabandPay test"
  ["timeout"] => string(1) "0"
  ["pay_method"] => string(8) "online"
  ["sub_pay_method"] => string(6) "WeChat Pay"
  ["order_id"] => string(17) "20180902014018888"
  ["amount"] => string(3) "0.1"
  ["currency"] => string(3) "EUR"
  ["redirect_url"] => string(49) "https://www.yabandpay.com"
  ["notify_url"] => string(44) "https://www.yabandpay.com/notify"
  ["demo"] => string(4) "test"
  ["user"] => string(20) "YOUR_CASHIER_UID"
  ["method"] => string(17) "v3.CreatePayments"
  ["time"] => int(1555498137)
}
b) Sort all payment parameters
array(13) {
  ["amount"] => string(3) "0.1"
  ["currency"] => string(3) "EUR"
  ["demo"] => string(3) "test"
  ["description"] => string(27) "YabandPay test"
  ["method"] => string(17) "v3.CreatePayments"
  ["notify_url"] => string(44) "https://www.yabandpay.com/notify"
  ["order_id"] => string(17) "20180902014018888"
  ["pay_method"] => string(8) "online"
  ["redirect_url"] => string(49) "https://www.yabandpay.com"
  ["sub_pay_method"] => string(6) "WeChat Pay"
  ["time"] => int(1555498137)
  ["timeout"] => string(1) "0"
  ["user"] => string(20) "YOUR_CASHIER_UID"
}
c) Concatenate them into a URL-style query string
string(326) "amount=0.1&currency=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments&notify_url=https://www.yabandpay.com/notify&order_id=20180902014018888&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=WeChat Pay&time=1555498137&timeout=0&user=YOUR_CASHIER_UID"
d) Sign the resulting stringA using secret_key

In this example, secret_key is YOUR_SECRET_KEY

Le champ resulting signature is:

string(64) "YOUR_SIGNATURE"