Developers

Real-time events, delivered.

Subscribe to platform events — a card is used, a payout settles, an account is credited — and react in real time.

Register an endpoint, choose the events you care about, and Gate to Pay POSTs a signed JSON payload whenever they occur. Verify the signature to confirm authenticity.

Common events.

card.authorized

A card authorisation was requested or approved.

payout.settled

A payout reached its destination.

account.credited

Funds landed in an account.

payment.captured

An acquired payment was captured.

transaction.declined

A transaction was declined by rules or issuer.

settlement.completed

A settlement batch completed.

Example payload

Every event shares an envelope with an id, type and data object.

POST to your endpoint
{
  "id": "evt_2b9f1a",
  "type": "payout.settled",
  "created": 1789200000,
  "data": {
    "payout": "po_7c4e",
    "amount": 25000,
    "currency": "JOD",
    "status": "settled"
  }
}

Verify the signature

Each request includes a signature header. Compute the HMAC of the raw body with your signing secret and compare.

  • Use the raw request body, not the parsed JSON
  • Reject requests older than a few minutes
  • Return 2xx quickly and process asynchronously

Wire up your first webhook.

Create an endpoint in the sandbox and trigger a test event.