Reference
Reference API
Toutes les ressources exposees par l’API WanePay v1, leurs endpoints et leurs conventions.
Conventions
| Parametre | Type | Description |
|---|---|---|
Base URL | string | https://api.wanepay.com/v1 |
Authentification | header | Authorization: Bearer sk_test_… ou X-API-Key. |
Montants | integer | Toujours des entiers, dans la plus petite unite de la devise. |
Dates | string | ISO-8601 UTC (2024-03-01T12:00:00.000Z). |
Pagination | query | limit (1–100, defaut 25) et offset. Les listes renvoient total et has_more. |
Idempotence | header | Idempotency-Key sur toutes les creations. |
Tracage | header | Chaque reponse porte WanePay-Request-Id. |
Enveloppe de liste
{
"object": "list",
"data": [ /* ... */ ],
"has_more": true,
"total": 128,
"limit": 25,
"offset": 0
}Payments
POST
/v1/paymentsCreer un paiementcle secreteGET
/v1/paymentsListercle publique ou secreteGET
/v1/payments/:idRecuperercle publique ou secretePOST
/v1/payments/:id/cancelAnnulercle secreteGET
/v1/payments/:id/timelineChronologiecle publique ou secretePayment Links
POST
/v1/payment-linksCreercle secreteGET
/v1/payment-linksListercle publique ou secreteGET
/v1/payment-links/:idRecuperercle publique ou secretePOST
/v1/payment-links/:idModifiercle secreteGET
/v1/payment-links/:id/paymentsPaiements du liencle publique ou secretePayouts
POST
/v1/payoutsCreercle secreteGET
/v1/payoutsListercle publique ou secreteGET
/v1/payouts/:idRecuperercle publique ou secreteRefunds
POST
/v1/refundsCreercle secreteGET
/v1/refundsListercle publique ou secreteGET
/v1/refunds/:idRecuperercle publique ou secreteCustomers
POST
/v1/customersCreercle secreteGET
/v1/customersListercle publique ou secreteGET
/v1/customers/:idRecuperer (avec statistiques)cle publique ou secretePOST
/v1/customers/:idModifiercle secreteMoyens de paiement, solde et ledger
GET
/v1/payment-methodsMoyens disponibles par payscle publique ou secreteGET
/v1/balanceSolde disponible et en courscle publique ou secreteGET
/v1/ledgerEcritures comptablescle publique ou secrete{
"object": "list",
"country": "TG",
"currency": "XOF",
"environment": "sandbox",
"livemode": false,
"data": [
{
"payment_method": "mobile_money",
"networks": [
{
"network": "tmoney",
"connection_key": "sandbox_tg_tmoney",
"simulated": true,
"min_amount": 100,
"max_amount": 2000000,
"capabilities": {
"payin": true, "payout": true, "refund": true,
"partial_refund": true, "cancel": true
}
},
{ "network": "flooz", "connection_key": "sandbox_tg_flooz", "simulated": true }
]
},
{ "payment_method": "card", "networks": [ { "network": "card_network" } ] }
]
}Webhooks
GET
/v1/webhooksLister les endpointscle secretePOST
/v1/webhooksCreer un endpointcle secretePOST
/v1/webhooks/:idModifiercle secreteDELETE
/v1/webhooks/:idSupprimercle secretePOST
/v1/webhooks/testEnvoyer un evenement de testcle secreteGET
/v1/webhooks/deliveriesHistorique des livraisonscle secreteSandbox
POST
/v1/sandbox/simulateForcer une issuecle secretePOST
/v1/sandbox/fundCrediter le solde de testcle secreteGET
/v1/sandbox/scenariosScenarios disponiblescle publique ou secreteObjets
| Objet | Prefixe d’identifiant |
|---|---|
| payment | pay_ |
| payout | pout_ |
| refund | ref_ |
| payment_link | plink_ |
| customer | cus_ |
| event | evt_ |
| webhook_endpoint | whe_ |
| webhook_delivery | whd_ |
| api_key | key_ |
| ledger_entry | led_ |
- Chaque objet porte
environmentetlivemode: impossible de confondre une transaction sandbox avec une transaction reelle. - Aucun identifiant de connexion ni statut interne de reseau n’est expose par l’API publique.