WEBHOOKS
Webhook Events Reference
Every event Flowwithlit sends to your webhook URL, with full payload schemas.
All webhook payloads include
event (the event name) and data (the event payload).
Always verify the X-Flowwithlit-Signature header before processing. See Receiving Webhooks.charge.success
Fired when a customer completes a payment via the hosted checkout.
JSON
{
"event": "charge.success",
"data": {
"transaction_ref": "FLW_TXN_ABCD1234",
"amount": 500000,
"currency": "NGN",
"status": "successful",
"customer": {
"email": "john@example.com",
"name": "John Doe"
},
"meta": {
"order_id": "1042",
"product": "Premium Hoodie"
},
"is_test": true
}
}| Field | Type | Description |
|---|---|---|
data.transaction_ref | string | Unique transaction reference. Use this to verify with GET /v1/transaction/verify/{ref} |
data.amount | number | Amount in kobo (lowest denomination) |
data.currency | string | ISO 4217 code e.g. NGN |
data.customer.email | string | Customer email from checkout |
data.meta | object | Any metadata you passed to FlowPay.init() |
data.is_test | boolean | true if transaction was in test mode |
All Event Types
| Event | Description |
|---|---|
| charge.success | Checkout payment completed |
| charge.failed | Checkout payment failed |