Paiements

Payments

Encaissez un paiement quel que soit le moyen : WanePay selectionne la connexion, suit le statut et vous notifie.

Endpoints

POST/v1/paymentsCreer un paiementcle secrete

GET/v1/paymentsLister les paiementscle publique ou secrete

GET/v1/payments/:idRecuperer un paiementcle publique ou secrete

POST/v1/payments/:id/cancelAnnuler un paiementcle secrete

GET/v1/payments/:id/timelineChronologie techniquecle publique ou secrete

Creer un paiement

{
  "amount": 10000,
  "currency": "XOF",
  "country": "TG",
  "payment_method": "mobile_money",
  "network": "tmoney",
  "customer": {
    "name": "Ama Doe",
    "phone": "+22890000000",
    "email": "ama@example.tg"
  },
  "reference": "ORDER-12345",
  "description": "Commande boutique",
  "metadata": { "order_id": "12345" },
  "expires_in": 1800
}

Parametres

Parametre	Type	Description
`amount`requis	integer	Montant dans la plus petite unite de la devise. XOF n’a pas de decimale : `10000` = 10 000 XOF.
`currency`requis	string	Code ISO 4217 (XOF, XAF, GHS, NGN, USD, EUR).
`country`requis	string	Code ISO 3166-1 alpha-2 du pays de la transaction.
`payment_method`requis	string	`mobile_money`, `card`, `bank_transfer` ou `wallet`.
`network`	string	Reseau precis souhaite. Omis, WanePay choisit la connexion la plus prioritaire.
`customer`	object	name, email, phone. Le client est cree ou retrouve automatiquement.
`reference`	string	Votre reference interne (120 caracteres max).
`description`	string	Libelle affiche au client.
`metadata`	object	Jusqu’a 30 cles libres, renvoyees telles quelles.
`expires_in`	integer	Duree de validite en secondes (60 a 86400, defaut 1800).

Instrument de paiement

Pour le mobile money, le numero du customer.phone suffit : WanePay initie immediatement la demande d’autorisation. Si l’instrument manque — carte bancaire sans donnees de carte, par exemple — le paiement reste pending et la reponse contient une action redirect vers le checkout heberge.

{
  "status": "pending",
  "next_action": {
    "type": "redirect",
    "url": "/pay/9fzk2m4qd7",
    "message": "Redirigez le client vers le checkout pour finaliser le paiement."
  },
  "checkout_url": "https://pay.wanepay.com/pay/9fzk2m4qd7"
}

Statuts

Statut	Signification
`pending`	En attente — Le paiement attend une action du client.
`processing`	En cours — Le reseau traite la transaction.
`succeeded`	Reussi — Fonds encaisses, ledger credite, frais preleves.
`failed`	Echoue — Le reseau ou le client a refuse la transaction.
`cancelled`	Annule — Annulation par le marchand ou le client.
`expired`	Expire — Aucune confirmation avant expires_at.
`refunded`	Rembourse — Totalite du montant remboursee.
`partially_refunded`	Partiellement rembourse — Une partie du montant a ete remboursee.

Ces statuts sont ceux de WanePay. Les statuts internes des connexions ne sont jamais exposes : ils restent confines au coeur pour le diagnostic.

Filtres de liste

status — un ou plusieurs statuts separes par des virgules.
payment_method, network, customer_id, reference.
created_after / created_before — dates ISO-8601.
min_amount / max_amount, limit (max 100) et offset.