#The rules that keep an integration correct
- Never mark a payment paid from a redirect, a deep link or a client-side claim. Read the server.
- Send an
Idempotency-Keyon every write, and reuse it for retries of the same operation. - Verify webhook signatures over the raw body, and deduplicate on the event id.
- Treat a failed payout as unknown until you read it; do not retry a non-idempotent payout blindly.
- Keep the private key on the server. A publishable key is the only credential a bundle may hold.
#Operator tools are internal
The operator console and the API behind it are not part of an app integration, are not published in this reference, and are not reachable from the public API host. Do not call them from an app.
#Support
Include request_id from the response or error in any support message. It identifies the exact request in the server logs.