API Reference

Webhooks

Smile&Pay posts the final result (PAID / FAILED / CANCELED) to this endpoint — it is the resultUrl we send on every initiation. Unauthenticated because ZB's servers call it; unknown references are logged and ignored.

POSTSmile&Pay result callbackReceives the gateway callback and updates the matching transaction.

Smile&Pay result callback

Receives the gateway callback and updates the matching transaction.

POST/api/v1/webhooks/smilepay

Auth: Public

You never call this — it is documented so you know what updates your transactions. It always answers 200 so the gateway does not retry forever.

Body — required

Field	Type	Description
orderReference	string	Reference of the transaction being updated.

Body — optional (3)

Field	Type	Description
status	string	Gateway status (PAID, FAILED, CANCELED, PENDING…).
paymentOption	string	The method actually used, for hosted checkout.
clientFee, merchantFee	number	Fees, when reported.

Response · 200

{ "received": true, "applied": true }

Set PUBLIC_BASE_URL on the backend so the gateway can reach this URL — localhost is not reachable from ZB.
Until a webhook arrives, poll GET /api/v1/payments/{orderReference}?refresh=true.