Cross-Border Webhooks

NexaPay sends signed webhooks when a cross-border collection succeeds, fails, or requires review.

Events

Event	Description
`cross_border.collection.success`	Sent after the merchant NGN wallet has been credited.
`cross_border.collection.failed`	Sent when the provider reports the collection failed.
`cross_border.collection.review`	Sent when the provider confirmation does not match the expected amount or currency.

Success Payload

{
  "event": "cross_border.collection.success",
  "eventId": "evt_01K4ABCD1234XYZ",
  "businessId": "69e698368d883f70f4d4ed21",
  "businessName": "Acme Stores",
  "environment": "prod",
  "occurredAt": "2026-09-03T13:10:30.000Z",
  "data": {
    "transactionId": "NexaPay20260903140945570d4ed2170c3",
    "merchantReference": "ORDER-TEST-001",
    "sourceAmount": 100,
    "sourceCurrency": "KES",
    "targetAmount": 953.42,
    "targetCurrency": "NGN",
    "rate": 9.5342,
    "status": "COMPLETED",
    "provider": "brails",
    "providerReference": "0f3cd184-6978-4696-9ef8-50d552b7c342"
  }
}

Verification

Cross-border webhooks use the same signing headers and verification flow described in the main Webhooks page.