Initialisation d'une transaction

Url de l'api

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
Copy

Comment générer un lien de paiement

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
Copy

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": []
}
Copy

Le lien est valide avant la date du expired_at

Guichet de paiement

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.

guichet