En vous inscrivant sur la plateforme de test, votre compte de test sera crédité de 100.000 Fcfa. Cela vous permettra d’éffectuer en toute aisance les tests d’intégration avant de passer en production.
Envoi de la requête
méthode
POST
url
https://app.payplus.africa/pay/v01/redirect/checkout-invoice/create
headers
Apikey
: contient la clé principale générée lors de la création de votre application
Authorization
: contient le mot Bearer
suivi d’un espace
puis du token généré lors de la création de votre application
payload ( format json )
{
"commande": {
"invoice": {
"items": [
{
"name": "Article 1",
"description": "",
"quantity": 1,
"unit_price": 950,
"total_price": 950
},
{
"name": "Article 2",
"description": "",
"quantity": 1,
"unit_price": 1950,
"total_price": 1950
}
],
"total_amount": 1900,
"devise": "xof",
"description": "Description du contenu de la facture",
},
"store": {
"name": "Nom de votre site ou de votre boutique",
"website_url": "url de votre site ou de votre boutique"
},
"actions": {
"cancel_url": "url d'annulation de la requete",
"return_url": "url de retour apres validation de la requete",
"callback_url": "url de retour apres validation de la requete"
},
"custom_data": {
"rubrique 1": "valeur_de_la_rubrique_1"
"rubrique 2": "valeur_de_la_rubrique_2"
}
}
}
Réponse ( format json )
{
"response_code":"contient 00 si succes. si different de 00 alors echec",
"token"=>"token de la transaction. il faut la conserver sur votre plateforme",
"response_text"=>"contient l'url de la page de validation de paiement (page vers laquelle vous devez rediriger le client pour qu'il procède au paiement) ",
"description"=>"message texte décrivant le résultat de la requête",
"customdata"=>"contient les custom_data envoyées lors de l'envoie de la requête"
}
Vérification du statut de la requête
méthode
GET
url
https://app.payplus.africa/pay/v01/redirect/checkout-invoice/confirm/?invoiceToken=
headers
Apikey
: contient la clé principale générée lors de la création de votre application
Authorization
: contient le mot Bearer
suivi d’un espace
puis du token généré lors de la création de votre application
Paramètres de l’url
invoiceToken
: contient le token que vous avez recu apres l’envoi de la requete
Réponse ( format json )
{
"response_code":"contient 00 si succes. si different de 00 alors echec",
"token"=>"id de la facture. il faut la conserver sur votre plateforme",
"response_text"=>"message texte décrivant le résultat de la requête",
"status"=>"indique le statut de la requête. valeurs possibles : pending (transaction en attente de validation), completed (transaction validée), notcompleted (transaction annulée). ce champ est vide si response_code est different de 00"
"customdata"=>"contient les custom_data envoyées lors de l'envoie de la requête"
}