Skip to main content

​
Outbound client webhook sample

{
  "event": "transaction.refund",
  "client": "6808f7f32db4d7c5e3f91a11",
  "createdAt": "2026-04-23T10:02:01.000Z",
  "data": {
    "eventType": "transaction.refund",
    "cardId": "6808f7f32db4d7c5e3f91b22",
    "cardHolderId": "6808f7f32db4d7c5e3f91c33",
    "accountId": "6808f7f32db4d7c5e3f91d44",
    "transaction": {
      "_id": "6808f7f32db4d7c5e3f91e57",
      "amount": 12.5,
      "fee": 0,
      "vat": 0,
      "currency": "USD",
      "type": "refund",
      "merchantAmount": 12.5,
      "merchantCurrency": "USD",
      "merchant": {
        "category": "5732",
        "name": "ACME ELECTRONICS",
        "merchantId": "MID556677",
        "city": "Port Harcourt",
        "state": "RI",
        "country": "NG",
        "postalCode": "500001"
      },
      "terminal": {
        "rrn": "300123456789",
        "stan": "112233",
        "terminalId": "TERM5566",
        "terminalOperatingEnvironment": "card_not_present",
        "terminalAttendance": "attended",
        "terminalType": "ecommerce",
        "panEntryMode": "manual",
        "pinEntryMode": "none",
        "cardHolderPresence": false,
        "cardPresence": false
      },
      "transactionMetadata": {
        "channel": "web",
        "type": "refund",
        "reference": "refund-ref-1003"
      },
      "metadata": {
        "eventType": "transaction.refund",
        "environment": "production",
        "business": "business_123",
        "authorization": "sudo_auth_approved_01",
        "reference": "refund-ref-1003",
        "feeDetails": [
          {
            "name": "processing_fee",
            "amount": 0
          }
        ]
      },
      "createdAt": "2026-04-23T10:02:00.000Z",
      "updatedAt": "2026-04-23T10:02:00.000Z"
    },
    "refund": {
      "authorization": "sudo_auth_approved_01",
      "feeDetails": [
        {
          "name": "processing_fee",
          "amount": 0
        }
      ],
      "reference": "refund-ref-1003"
    },
    "context": {
      "eventId": "evt_sudo_03",
      "environment": "production",
      "business": "business_123",
      "createdAt": 1713878520
    }
  }
}