Wallet withdrawals settle when the network confirms them. A crypto withdrawal now stays
processing until the transfer confirms, then you get transaction.withdrawal.completed. If it fails, the amount goes back to your balance once and you get transaction.withdrawal.failed. Before, it showed completed as soon as it was sent.Unconfirmed payouts aren’t refunded early. If a bank or network doesn’t say clearly whether a payout went through, it stays processing while we check, rather than being refunded and possibly paid twice.Amounts must be numbers. Amount fields that are missing, not a number, or not positive now get 400, with every problem in details.errors.A fuller API reference. Every endpoint now shows a request you can send, the response you get back, and each error it can return. Rate-limited requests now say Too many requests. Slow down and try again shortly.Payments must match. A checkout payment more than 1% short, or in a different token from the one asked for, is held for review instead of completing. Each deposit is credited once, for what actually arrived.Sandbox.
fpay_test_ keys run every endpoint in test mode: nothing reaches a bank or a blockchain. Settle payments with Simulate an outcome and add funds with Add test funds. See Sandbox.Test and live keys. Keys start with fpay_test_ or fpay_live_, are stored only as a hash, and can be rolled or revoked on request. Keys also work as Authorization: Bearer.Webhooks per mode. Each mode has its own webhook URL and signing secret. Every webhook has a timestamped x-flipeetpay-signature-v2 signature, so you can refuse replays, plus x-flipeetpay-event, x-flipeetpay-mode and x-flipeetpay-delivery headers. The original x-flipeetpay-signature is unchanged. Failed deliveries are retried after 5 and 30 seconds. See Webhooks.Errors. Every error has a stable code, a requestId and, for validation, details.errors. Every response has an X-Request-Id header. See Errors.Rate limits. Each key can make 120 requests a minute. See Rate limits.Checkout fee. Checkouts are credited in the payment’s currency, less 0.5%.