API Doc
Génération de formulaires

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:
, CDF CONGO - afrimoney-congo.cdf
, 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
Bitcoin, BTC - bitcoin
, BCH - bitcoin_cash
, LINK - link
, XOF BURKINA-FASO - coris-burkina-faso.xof
, ZAR SOUTH-AFRICA - eft-south-africa.zar
Ethereum, ETH - ethereum
, XOF SENEGAL - expresso-senegal.xof
FreeMoney, XOF SENEGAL - free_money-senegal.xof
, TZS TANZANIA - halotel-tanzania.tzs
, INR - imps.inr
Litecoin, LTC - litecoin
Monero, XMR - monero
MOOV, XOF TOGO - moov-togo.xof
MOOV, XOF CI - moov-ci.xof
MOOV, XOF BENIN - moov-benin.xof
MOOV, XOF MALI - moov-mali.xof
MOOV, 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
MTN, XOF TOGO - mtn-togo.xof
MTN, XOF CI - mtn-ci.xof
MTN, XOF BENIN - mtn-benin.xof
MTN, GNF GUINEA - mtn-guinea.gnf
MTN, XAF CAMEROON - mtn-cameroon.xaf
MTN, GHS GHANA - mtn-ghana.ghs
MTN, RWF RWANDA - mtn-rwanda.rwf
MTN, UGX UGANDA - mtn-uganda.ugx
MTN, ZMW ZAMBIA - mtn-zambia.zmw
, MGA - mvola.mga
, NGN - opay.ngn
Orange Money, MGA - orange_money.mga
Orange Money, XOF TOGO - orange_money-togo.xof
Orange Money, XOF CI - orange_money-ci.xof
Orange Money, XOF SENEGAL - orange_money-senegal.xof
Orange Money, XOF BURKINA-FASO - orange_money-burkina-faso.xof
Orange Money, XOF MALI - orange_money-mali.xof
Orange Money, USD CONGO - orange_money-congo.usd
Orange Money, CDF CONGO - orange_money-congo.cdf
Orange Money, GNF GUINEA - orange_money-guinea.gnf
Orange Money, XAF CAMEROON - orange_money-cameroon.xaf
Orange Money, RWF RWANDA - orange_money-rwanda.rwf
Orange Money, SLE SIERRA-LEONE - orange_money-sierra-leone.sle
, NGN - palmpay.ngn
, INR - paytm.inr
, INR - phonepe.inr
T-Money, XOF TOGO - tmoney.xof
, KES KENYA - tcash-kenya.kes
Tether ERC20, USDT ERC20 - usdt_erc20
Tether TRC20, USDT TRC20 - usdt_trc20
, GHS GHANA - tigo-ghana.ghs
, TZS TANZANIA - tigo-tanzania.tzs
, MWK MALAWI - tnm-malawi.mwk
Tron, TRX - tron
, INR - upi.inr
, USDC TRC20 - usdc_trc20
, MGA - vanilla_pay.mga
, NGN - verve.ngn
Visa/Master, UAH - visamaster.uah
Visa/Master, USD - visamaster.usd
Visa/Master, EUR - visamaster.eur
Visa/Master, NGN - visamaster.ngn
, CDF CONGO - vodafone-congo.cdf
, GHS GHANA - vodafone-ghana.ghs
, TZS TANZANIA - vodafone-tanzania.tzs
Wave, XOF SENEGAL - wave-senegal.xof
Wave, XOF CI - wave-ci.xof
, XOF SENEGAL - wiz_all-senegal.xof
, ZMW ZAMBIA - zamtel-zambia.zmw
, NGN - cash_terminal.ngn
, AFG - cash_terminal.afg
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;