Intégration avec redirection

Attention !!! Pour vos tests, connectez vous plutôt à la plateforme de test. Connexion à la Plateforme de test

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"
}