La requête doit être envoyée via la methode HTTP POST
.L'url de l'api pour initialiser une transaction est :
https://api.winipayer.com/transaction/invoice/create
Pour générer le lien de paiement, vous devez utiliser les paramètres suivants:
Paramètre | Type | Obligatoire | Description |
---|---|---|---|
X-Merchant-Apply | String | Oui |
Votre X-Merchant-Apply un paramètre dans le header (fourni par Winipayer) EX: 4ucOUvh0i18KNfR3SR48 |
X-Merchant-Token | String | Oui |
Votre X-Merchant-Token un paramètre dans le header (fourni par Winipayer)EX: a7192037-3c56-45f5-8018-aaa402412ab8 |
env | String | Oui |
test : pour les tests et prod :pour la production |
version | String | Oui |
La version de l'api v1 |
amount | Float | Oui |
Le montant de la transaction(ex: 100000) |
currency | String | Oui |
La devise de la transaction (xof ) |
cancel_url | String | Oui |
Le lien de retour après annulation par le client |
callback_url | String | Oui |
Le lien de callback (lien de validation Ipn) |
return_url | String | Oui |
Le lien de return (lien de retour après paiment) |
channel | Json | Non |
Sert à définir les moyens de paiement acceptés sur le guichet (wave-cote-divoire, orange-cote-divoire, stripe ...) par defaut tous les réseaux disponible |
items | Json | Non |
Toute information supplémentaire que vous voulez afficher sur la facture concernant le panier EX : [{"name": "Pot de fleure","quantity": 3,"unit_price": 2000,"description": ""},...] NB: Ces informations sont à titre d'information et n'impactent en aucun cas la facture |
custom_data | String | Non |
Toute information supplémentaire que vous voulez afficher sur la facture |
Les partenaires disponible sont accessible via cette url via la methode POST
https://api.winipayer.com/all/partner/list
{success} Voici un exemple de reponse de succès en
JSON
{
"success": true,
"results": {
"invoice_uuid": "c87cdcd6-4e77-41b3-9757-e1013dae20e6",
"process_url": "https://checkout.winipayer.com/int/v1/test/c87cdcd6-4e77-41b3-9757-e1013dae20e6",
"expired_at": "2023-12-28 10:54:35"
},
"errors": [],
"messages": []
}
{danger.fa-close} Le lien est valide avant la date du
expired_at
Après avoir obtenu l’url de paiement à la requête précédente, il vous suffit juste de lancer cette url dans un navigateur web pour vous retrouver sur le guichet de paiement.