Formulaire d'acceptation de paiement
Description du schéma de fonctionnement.
Côté serveur Web du client, un formulaire de paiement est généré et envoyé à l'utilisateur pour soumission.
Après avoir soumis le formulaire, l'utilisateur est redirigé vers le traitement pour effectuer un paiement.
Une fois le paiement effectué, l'utilisateur revient soit à SUCCESS_URL, soit à FAIL_URL. Un GET vide est à son tour envoyé à STATUS_URL une demande à réception de laquelle vous devez demander l'état du paiement (request /api/einvoice/status Accounts - Vérification de l'état actuel du compte) en transmettant INVOICE_ID à partir du formulaire généré précédemment et, en fonction de la réponse reçue, prenez d'autres mesures.
Si vous devez accepter un paiement sans vous rendre sur le site de traitement, alors le formulaire doit être envoyé en tant que paramètres GET à la même adresse et ouvrir la page dans IFRAME sur le site Internet du commerçant. p>
<form action="https://acs.dpay.africa/acs" method="POST"> <input type="hidden" name="CLIENT_ID" value="numéro de caisse" /> <input type="hidden" name="SIGN" value="signature du formulaire" /> <input type="hidden" name="SIGN_ORDER" value="AMOUNT;CURRENCY;..." /> <input type="hidden" name="INVOICE_ID" value="numéro de commande" /> <input type="hidden" name="AMOUNT" value="100.00" /> <input type="hidden" name="ACCOUNT" value="123" /> <input type="hidden" name="CURRENCY" value="USD" /> <input type="hidden" name="PAYMENT_CURRENCY" value="visamaster.usd" /> <input type="hidden" name="DESCRIPTION" value="Some payment description" /> <input type="hidden" name="SUCCESS_URL" value="https://test.com/success/invoice_id" /> <input type="hidden" name="FAIL_URL" value="https://test.com/fail/invoice_id" /> <input type="hidden" name="STATUS_URL" value="https://test.com/status/invoice_id" /> </form>
Explication des champs (les champs marqués d'un astérisque sont obligatoires)
| Champ | Description |
|---|---|
| CLIENT_ID* | Numéro de caissier de votre compte personnel |
| SIGN* | Demander une signature |
| SIGN_ORDER* | L'ordre de concaténation des champs lors de la génération d'une signature |
| INVOICE_ID* | Numéro de compte dans le système comptable du magasin. Les numéros de compte doivent être uniques (l'unicité est vérifiée) !!! Avec un seul numéro, vous ne pouvez accepter le paiement qu'une seule fois !!! |
| AMOUNT* | Montant à radier |
| ACCOUNT | ID utilisateur dans le système marchand (numéro de compte ou tout autre identifiant unique) |
| CURRENCY* | Devise de facturation. Devises disponibles: UAH, USD, EUR, LTC, BTC, BCH, USDT |
| PAYMENT_CURRENCY | Devise dans laquelle le paiement doit être accepté. Devises disponibles: , MGA - airtel.mga , USD CONGO - airtel-congo.usd , CDF CONGO - airtel-congo.cdf , XAF CAMEROON - airtel-cameroon.xaf , XAF CONGO-BRAZZAVILLE - airtel-congo-brazzaville.xaf , GHS GHANA - airtel-ghana.ghs , KES KENYA - airtel-kenya.kes , MWK MALAWI - airtel-malawi.mwk , RWF RWANDA - airtel-rwanda.rwf , TZS TANZANIA - airtel-tanzania.tzs , UGX UGANDA - airtel-uganda.ugx , ZMW ZAMBIA - airtel-zambia.zmw , NGN - bank.ngn , BTC - bitcoin , BCH - bitcoin_cash , LINK - link , ZAR SOUTH-AFRICA - eft-south-africa.zar , ETH - ethereum , XOF SENEGAL - expresso-senegal.xof , XOF SENEGAL - free_money-senegal.xof , TZS TANZANIA - halotel-tanzania.tzs , INR - imps.inr , LTC - litecoin , XMR - monero , XOF TOGO - moov-togo.xof , XOF CI - moov-ci.xof , XOF BENIN - moov-benin.xof , XOF MALI - moov-mali.xof , XOF BURKINA-FASO - moov-burkina-faso.xof , USD CONGO - mpesa-congo.usd , CDF CONGO - mpesa-congo.cdf , KES KENYA - mpesa-kenya.kes , TZS TANZANIA - mpesa-tanzania.tzs , XOF TOGO - mtn-togo.xof , XOF CI - mtn-ci.xof , XOF BENIN - mtn-benin.xof , GNF GUINEA - mtn-guinea.gnf , XAF CAMEROON - mtn-cameroon.xaf , GHS GHANA - mtn-ghana.ghs , RWF RWANDA - mtn-rwanda.rwf , UGX UGANDA - mtn-uganda.ugx , ZMW ZAMBIA - mtn-zambia.zmw , MGA - mvola.mga , NGN - opay.ngn , MGA - orange_money.mga , XOF TOGO - orange_money-togo.xof , XOF CI - orange_money-ci.xof , XOF SENEGAL - orange_money-senegal.xof , XOF BURKINA-FASO - orange_money-burkina-faso.xof , XOF MALI - orange_money-mali.xof , USD CONGO - orange_money-congo.usd , CDF CONGO - orange_money-congo.cdf , GNF GUINEA - orange_money-guinea.gnf , XAF CAMEROON - orange_money-cameroon.xaf , RWF RWANDA - orange_money-rwanda.rwf , SLL SIERRA-LEONE - orange_money-sierra-leone.sll , NGN - palmpay.ngn , INR - paytm.inr , INR - phonepe.inr , XOF - tmoney.xof , KES KENYA - tcash-kenya.kes , USDT ERC20 - usdt_erc20 , USDT TRC20 - usdt_trc20 , GHS GHANA - tigo-ghana.ghs , TZS TANZANIA - tigo-tanzania.tzs , MWK MALAWI - tnm-malawi.mwk , TRX - tron , INR - upi.inr , USDC TRC20 - usdc_trc20 , MGA - vanilla_pay.mga , NGN - verve.ngn , UAH - visamaster.uah , USD - visamaster.usd , EUR - visamaster.eur , NGN - visamaster.ngn , XOF - visamaster.xof , CDF CONGO - vodafone-congo.cdf , GHS GHANA - vodafone-ghana.ghs , TZS TANZANIA - vodafone-tanzania.tzs , XOF SENEGAL - wave-senegal.xof , XOF CI - wave-ci.xof , XOF SENEGAL - wiz_all-senegal.xof , ZMW ZAMBIA - zamtel-zambia.zmw , NGN - cash_terminal.ngn |
| DESCRIPTION | Description du compte |
| SUCCESS_URL* | URL vers laquelle l'utilisateur sera redirigé après un paiement réussi |
| FAIL_URL* | URL vers laquelle l'utilisateur sera redirigé après un paiement infructueux |
| STATUS_URL* | URL vers laquelle un callback sera envoyé lorsque le compte passera au statut final. Une requête GET vide est envoyée, à réception de laquelle le commerçant doit demander l'état du compte via l'API et prendre une décision sur la base des données reçues |
Lors de la soumission d'une demande, l'un des champs CURRENCY ou PAYMENT_CURRENCY est obligatoire. Si deux champs sont renseignés, la priorité est donnée à PAYMENT_CURRENCY et le champ CURRENCY est ignoré.
Un exemple de formation d'une signature en PHP.
$clientID = 123; $secret = "qwertyuiop123456"; $data = [ "CLIENT_ID" => $clientID, "INVOICE_ID" => "1", "AMOUNT" => "100", "CURRENCY" => "USD", "PAYMENT_CURRENCY" => "visamaster.usd", "DESCRIPTION" => "Test payment", "SUCCESS_URL" => "https://test.com/success/1", "FAIL_URL" => "https://test.com/fail/1", "STATUS_URL" => "https://test.com/status/1" ]; $sign = base64_encode(md5($secret . base64_encode(sha1(implode("", $data), true)) . $secret, true)); $data["SIGN_ORDER"] = implode(";", array_keys($data)); $data["SIGN"] = $sign;