Skip to main content
WEBHOOK
charge.completed
{
  "webhook_id": "<string>",
  "timestamp": 123,
  "data": {
    "id": "<string>",
    "amount": 12.34,
    "currency": "NGN",
    "customer": {
      "id": "cus_3XarBILKQS",
      "email": "cornelius@gmail.com",
      "name": {
        "first": "King",
        "middle": "Leo",
        "last": "LeBron"
      },
      "phone": {
        "country_code": "234",
        "number": "08012345678"
      },
      "meta": {},
      "created_datetime": "2023-11-07T05:31:56Z"
    },
    "description": "<string>",
    "meta": {},
    "payment_method": {
      "id": "pmd_WRq7L4TM8p",
      "type": "card",
      "card": {
        "expiry_month": "09",
        "expiry_year": "32",
        "first6": "123412",
        "last4": "1234",
        "network": "MASTERCARD",
        "card_holder_name": "Alex James"
      },
      "customer_id": "cus_3XarBILKQS",
      "meta": {},
      "device_fingerprint": "62wd23423rq324323qew1",
      "client_ip": "154.123.220.1",
      "created_datetime": "2024-12-03T13:54:21.546559974Z"
    },
    "redirect_url": "<string>",
    "reference": "<string>",
    "status": "<string>",
    "created_datetime": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Notification about a completed charge

Charge completion webhook payload

​
webhook_id
string
required

Webhook event identifier

​
timestamp
integer<int64>
required

Webhook event timestamp

​
type
enum<string>
required

Webhook event type

Available options:
charge.completed,
transfer.disburse,
transfer.reversal,
order.authorization
​
data
object
required

Response

200

Return a 200 status to indicate that the webhook was received successfully