PAYMENT.RECIEVED

This event is dispatched whenever a merchant receives payment.

{
  "event": "payment.received",
  "data": {
    "transaction": {
      "reference": "bq_RkaUV0Zy3PGpQsT8c",
      "merchant_name": "Bar BQ Express",
      "payment_currency": 3,
      "payment_currency_name": "Bitcoin",
      "payment_currency_slug": "BTC",
      "status": "SUCCESSFUL",
      "customer_email": "[email protected]",
      "customer_name": "John Doe",
      "payment_amount": 1,
      "amount_paid": 1,
      "description": "Payment for Lamborghini",
      "is_live": false,
      "created_at": "2026-02-09T16:18:20.000Z",
      "meta": {}
    }
  }
}
FieldDescriptionType
eventThe webhook event action that triggered the webhookString
dataAll information related to this specific webhook.Object
data.transactionAll information related to the transaction is being carried out.Object
data.transaction.referenceBasqet transaction referenceString
data.transaction.merchant_nameBasqet merchant nameString
data.transaction.payment_currencyTransaction currency idString
data.transaction.payment_currency_slugTransaction currency slugString
data.transaction.customer_emailYour customer's emailString
data.transaction.customer_nameYour customer's nameString
data.transaction.statusTransaction status ("INITIATED","PENDING","ABANDONED","SUCCESSFUL")String
data.transaction.payment_amountPayment amount (Amount User was to pay)String
data.transaction.amount_paidAmount Paid (Amount user sent to wallet address)String
data.transaction.descriptionDescription of paymentString
data.transaction.is_liveLive or Sandbox transactionBoolean