First Payment

Initiate a payment

POST /api/v1/payments/initiate
Authorization: Bearer sk_live_YOUR_API_KEY
Content-Type: application/json

{
  "amount": 5000,
  "currency": "XOF",
  "operatorSlug": "orange-money-ci",
  "customerPhone": "+2250700000000",
  "customerName": "John Doe",
  "merchantRef": "ORDER-12345",
  "notifyUrl": "https://your-site.com/webhooks/mabipay",
  "successUrl": "https://your-site.com/thank-you",
  "failedUrl": "https://your-site.com/error"
}

Response:

{
  "reference": "TXN-20240615-ABCD1234",
  "status": "pending",
  "amount": 5000,
  "currency": "XOF",
  "paymentUrl": "https://checkout.mabipay.com/pay/TXN-20240615-ABCD1234"
}

Check status

GET /api/v1/payments/TXN-20240615-ABCD1234
Authorization: Bearer sk_live_YOUR_API_KEY

Payment statuses

Status	Description
pending	Awaiting confirmation
processing	Being processed
success	Payment successful
failed	Payment failed
expired	Payment expired
cancelled	Cancelled