Skip to main content

Headers

Request body

Decrypted payload:

Example request

All examples assume you’ve already encrypted the body and signed the request — see the Quickstart for the full helper in Node and Python.

Responses

200 — Success

status is one of: status_message is non-null only on failed, rejected, reversed, canceled.

400 — validation_error

transaction_id missing or malformed (must be a UUID or start with sb_).

401 — unauthorized / jwt_expired

Bad/missing JWT.

404 — not_found

Transaction doesn’t exist or belongs to a different account.

429 — rate_limited

Throttle your polling.

Recommendation

Polling works, but register a Callback URL to stop polling entirely. We POST to you as soon as the transaction reaches a final state.