Après avoir suivi les étapes se trouvant dans la partie introduction, vous pouvez intégrer dès lors ce client API
en suivant les étapes ci-dessous.
Pour effectuer un retrait vous aviez besoin de vos clés API dans votre compte PayDunya. Donc connectez-vous à votre compte PayDunya déjà
créé et accéder à vos clés d'API
par le lien détails
se trouvant juste à droite de l'application que vous aviez créé.
Ainsi vous pouvez faire retirer vos clients de plusieurs manières, à savoir par ORANGE MONEY PORTE-MONNAIE
et par le compte PayDunya
. Pour cela il vous faudra disposer de trois 03 clés
au format JSON
.
Les trois 03 clés JSON
à avoir sont les suivantes :
"account_alias"
:
Est le numéro de téléphone du destinataire sans code de pays.
"amount"
Est le montant à débourser en XOF
"withdraw_mode"
Définit le point de terminaison de retrait: "orange-money-senegal"
pour "Orange Money wallet"
.
Pour "PayDunya compte"
, vous devez tout simplement ne pas utilizer la clé JSON
"withdraw_mode"
.
Veillez à ce que l'API PER ou déboursement soit activé
dans votre dashboard au niveau de API WebPay et MobPay. votre dashboard
account_alias
: numéro de téléphone du receveur sans le country code du pays.
amount
: c'est le montant du déboursement en XOF.
withdraw_mode
: on a différents withdraw_mode :
orange-money-senegal
: pour le wallet orange money Sénégal
free-money-senegal
: pour le wallet free money Sénégal.
expresso-senegal
: pour le wallet e-money Sénégal.
wave-senegal
: pour le wallet wave Sénégal.
mtn-benin
: pour le wallet mtn Bénin.
moov-benin
: pour le wallet Moov Bénin.
mtn-ci
: pour le wallet mtn Côte d'Ivoire.
orange-money-ci
: pour le wallet Orange Money Côte d'Ivoire.
moov-ci
: pour le wallet moov Côte d'Ivoire.
wave-ci
: pour le wallet wave Côte d'Ivoire.
t-money-togo
: pour le wallet T-Money Togo.
orange-money-mali
: pour le wallet Orange Money Mali.
orange-money-burkina
: pour le wallet Orange Money Burkina.
https://app.paydunya.com/api/v1/disburse/get-invoice
curl -H "Content-Type: application/json" \
-H "PAYDUNYA-MASTER-KEY: wQzk9ZwR-Qq9m-0hD0-zpud-je5coGC3FHKW" \
-H "PAYDUNYA-PRIVATE-KEY: test_private_rMIdJM3PLLhLjyArx9tF3VURAF5" \
-H "PAYDUNYA-TOKEN: IivOiOxGJuWhc5znlIiK" \
-X POST -d ' { "account_alias" : "771111111", "amount" : 4500, "withdraw_mode" :
"orange-money-senegal" }' \
"https://app.paydunya.com/api/v1/disburse/get-invoice"
“account_alias”
et “amount”
sont obligatoires. Pour changer le “withdraw_mode”
il vous suffit juste de remplacer selon le moyen de paiement que vous voulez utiliser, parmis la liste qui a été donnée en dessus..
“amount”
ne doit pas être une valeur décimale et la devise prise en charge est XOF, “account_alias”
doit être un numéro de téléphone sans code de pays.
{
"response_code": "00",
"disburse_token": "hwTHAS0WvTmTaYT2zDoO"
}
https://app.paydunya.com/api/v1/disburse/get-invoice
curl -H "Content-Type: application/json" \
-H "PAYDUNYA-MASTER-KEY: wQzk9ZwR-Qq9m-0hD0-zpud-je5coGC3FHKW" \
-H "PAYDUNYA-PRIVATE-KEY: test_private_rMIdJM3PLLhLjyArx9tF3VURAF5" \
-H "PAYDUNYA-TOKEN: IivOiOxGJuWhc5znlIiK" \
-X POST -d ' { "account_alias" : "705962914", "amount" : 4500 }' \
"https://app.paydunya.com/api/v1/disburse/get-invoice"
{
"response_code": "00",
"disburse_token": "hwTHAS0WvD4TaZW2zDoO"
}
Pour soumettre un décaissement, vous devez soumettre les paramètres d'entrée disburse_invoice
et disburse_id
pour que le décaissement soit traité. disburse_id
est votre propre numéro de référence de transaction, il est facultatif. Si vous ne l'avez pas, publiez simplement la demande avec uniquement disburse_invoice
(obligatoire) comme paramètre d'entrée.
https://app.paydunya.com/api/v1/disburse/submit-invoice
curl -H "Content-Type: application/json" \
-H "PAYDUNYA-MASTER-KEY: wQzk9ZwR-Qq9m-0hD0-zpud-je5coGC3FHKW" \
-H "PAYDUNYA-PRIVATE-KEY: test_private_rMIdJM3PLLhLjyArx9tF3VURAF5" \
-H "PAYDUNYA-TOKEN: IivOiOxGJuWhc5znlIiK" \
-X POST -d ' {"disburse_invoice": "hwTHAS0WvTmTaYT2zDoO ", " disburse_id ": "456678900309" }' \
"https://app.paydunya.com/api/v1/disburse/submit-invoice"
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": " Success! PayDunya withdrawal code corresponding to an amount of 4500 FCFA has been transfered to Christopher Jean. Phone number: 771111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to Orange Money Account 771111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to Free-Money Account 761111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
OU
{
"response_code": "00",
"response_text": "Transaction pending",
"description": "Transaction pending, please check the final status later through our status API or contact our customer care",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": null
}
{
"response_code": "00",
"response_text": "Transaction completed successfully"",
"description": "Success! Amount of 4500 FCFA has been transfered to E Money Account 771111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to Wave Account 777777777",
"transaction_id": "TFA-TX-0sks0bagCMQkZ0SG91nc",
"provider_ref": "pt-67Ggh7zgm013syghghjkhgjh"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully"",
"description": "Success! Amount of 4500 FCFA has been transfered to Mtn Money Account 0588118811",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 200.00 FCFA has been transfered to MOOV BJ Account 95920904",
"transaction_id": "TFA-TX-E36T8kfja2cpR00CKuVq",
"provider_ref": "920230224297772"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully"",
"description": "Success! Amount of 4500 FCFA has been transfered to Mtn Money Account 0588118811",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to Orange Money CI Account 0577111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 200 FCFA has been transfered to MOOV CI Account 0153401679",
"transaction_id": "TFA-TX-FVTMk4jGgWZ8s3WN4dwE",
"provider_ref": "9220613074705"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to Wave Account 777777777",
"transaction_id": "TFA-TX-0sks0bagCMQkZ0SG91nc",
"provider_ref": "pt-67Ggh7zgm013syghghjkhgjh"
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 4500 FCFA has been transfered to T-Money Account 77111111",
"transaction_id": "TFA-TX-37XqPpVCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
'response_text' => 'PENDING',
'description' => 'Transaction in pending'
}
{
"response_code": "00",
"response_text": "Transaction completed successfully",
"description": "Success! Amount of 200 FCFA has been transfered to Orange Money Burkina 66123421",
"transaction_id": "TFA-TX-37XqPpjCjU7ReiycUg97",
"provider_ref": "565486545315"
}
{
'response_text' => 'PENDING',
'description' => 'Transaction in pending'
}
https://app.paydunya.com/api/v1/disburse/check-status
curl -H "Content-Type: application/json" \
-H "PAYDUNYA-MASTER-KEY: wQzk9ZwR-Qq9m-0hD0-zpud-je5coGC3FHKW" \
-H "PAYDUNYA-PRIVATE-KEY: test_private_rMIdJM3PLLhLjyArx9tF3VURAF5" \
-H "PAYDUNYA-TOKEN: IivOiOxGJuWhc5znlIiK" \
-X POST -d ' {"disburse_invoice": "hwTHAS0WvTmTaYT2zDoO"}' \
"https://app.paydunya.com/api/v1/disburse/check-status"
{
"response_code": "00",
"status": "success",
"token": "hwTHAS0WvTmTaYT2zDoO",
"withdraw_mode": "orange-money-senegal",
"amount": "4500",
"updated_at": "20/04/2020 15:57"
}
Mode de retrait non pris en charge
{
"response_code": "1001",
"response_text":
" Le mode de retrait envoyé n'est pas pris en charge!"
}
Pas assez de fonds dans le compte de l'expéditeur PayDunya
{
"response_code": "4002",
"response_text": " Vous n'avez pas assez de fonds. Envisagez de créditer votre compte ",
}
Le montant minimum est supérieur au montant à retirer
{
"response_code": "4003",
"response_text": " Échec du dépôt! Le montant doit être supérieur à 200 FCFA."
}