Intégration sans redirection

Attention !!! Cette fonctionnalite n’est pas disponible sur la plateforme test

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