Reference

Reference API

Toutes les ressources exposees par l’API WanePay v1, leurs endpoints et leurs conventions.

Conventions

ParametreTypeDescription
Base URLstringhttps://api.wanepay.com/v1
AuthentificationheaderAuthorization: Bearer sk_test_… ou X-API-Key.
MontantsintegerToujours des entiers, dans la plus petite unite de la devise.
DatesstringISO-8601 UTC (2024-03-01T12:00:00.000Z).
Paginationquerylimit (1–100, defaut 25) et offset. Les listes renvoient total et has_more.
IdempotenceheaderIdempotency-Key sur toutes les creations.
TracageheaderChaque 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 secrete
GET/v1/paymentsListercle publique ou secrete
GET/v1/payments/:idRecuperercle publique ou secrete
POST/v1/payments/:id/cancelAnnulercle secrete
GET/v1/payments/:id/timelineChronologiecle publique ou secrete

Payment Links

POST/v1/payment-linksCreercle secrete
GET/v1/payment-linksListercle publique ou secrete
GET/v1/payment-links/:idRecuperercle publique ou secrete
POST/v1/payment-links/:idModifiercle secrete
GET/v1/payment-links/:id/paymentsPaiements du liencle publique ou secrete

Payouts

POST/v1/payoutsCreercle secrete
GET/v1/payoutsListercle publique ou secrete
GET/v1/payouts/:idRecuperercle publique ou secrete

Refunds

POST/v1/refundsCreercle secrete
GET/v1/refundsListercle publique ou secrete
GET/v1/refunds/:idRecuperercle publique ou secrete

Customers

POST/v1/customersCreercle secrete
GET/v1/customersListercle publique ou secrete
GET/v1/customers/:idRecuperer (avec statistiques)cle publique ou secrete
POST/v1/customers/:idModifiercle secrete

Moyens de paiement, solde et ledger

GET/v1/payment-methodsMoyens disponibles par payscle publique ou secrete
GET/v1/balanceSolde disponible et en courscle publique ou secrete
GET/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 secrete
POST/v1/webhooksCreer un endpointcle secrete
POST/v1/webhooks/:idModifiercle secrete
DELETE/v1/webhooks/:idSupprimercle secrete
POST/v1/webhooks/testEnvoyer un evenement de testcle secrete
GET/v1/webhooks/deliveriesHistorique des livraisonscle secrete

Sandbox

POST/v1/sandbox/simulateForcer une issuecle secrete
POST/v1/sandbox/fundCrediter le solde de testcle secrete
GET/v1/sandbox/scenariosScenarios disponiblescle publique ou secrete

Objets

ObjetPrefixe d’identifiant
paymentpay_
payoutpout_
refundref_
payment_linkplink_
customercus_
eventevt_
webhook_endpointwhe_
webhook_deliverywhd_
api_keykey_
ledger_entryled_
  • Chaque objet porte environment et livemode : 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.