> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flipeet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Changes to the Flipeet Pay API, newest first.

**November 11, 2026**

Safer payouts and amounts

**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.

**November 10, 2026**

Sandbox, test keys and signed webhooks

**Sandbox.** `fpay_test_` keys run every endpoint in test mode: nothing reaches a bank or a blockchain. Settle payments with [Simulate an outcome](https://docs.flipeet.io/api-reference/sandbox/simulate-an-outcome.md) and add funds with [Add test funds](https://docs.flipeet.io/api-reference/sandbox/add-test-funds.md). See [Sandbox](https://docs.flipeet.io/sandbox.md).

**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](https://docs.flipeet.io/webhooks.md).

**Errors.** Every error has a stable `code`, a `requestId` and, for validation, `details.errors`. Every response has an `X-Request-Id` header. See [Errors](https://docs.flipeet.io/errors.md).

**Rate limits.** Each key can make 120 requests a minute. See [Rate limits](https://docs.flipeet.io/rate-limits.md).

**Checkout fee.** Checkouts are credited in the payment's currency, less 0.5%.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.