- 1ReceiveSapiom sends an event to your receiver.
- 2VerifyCheck the signature on the request.
- 3Store and respondSave the event, then reply within 10 seconds.
- 4Read the transactionFollow its next action.
Register your receiver
Use an API key from Create key in the dashboard’s API keys; it has theorg.write permission this needs. A platform key from Create platform key doesn’t. Store signingSecret server-side only.
Verify the signature
Sapiom signs each request with the Standard Webhooks headers. Verify them with your signing secret:verify-webhook.ts
Events
Sapiom sends three events:transaction.action_required(action:human_approvalorsecurity_code)transaction.payment_readytransaction.closed(statusdeniedorcancelled,reason)
Retries and duplicates
Sapiom retries after about a minute, backing off to six hours. A retry has the same eventid, so ignore ids you’ve already seen.
Read, replace or remove the receiver
Replacing the URL keeps the signing secret. To read the receiver:PUT as above with the new URL. To remove it: