Envoi de la requête
méthode
POST
url
https://app.payplus.africa/pay/v01/straight/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
Accept
: application/json
Content-Type
: application/json
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",
"customer": "contient le numero de telephone du client (format : 22997761182)",
"otp": "contient le code otp de la transaction (uniquement pour les abonnes orange money, sinon laisser vide.)"
},
"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/straight/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"
}