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

# Introduction

> Send cross-border payouts from your own software: fund a wallet, register payees and pay them in their local currency.

The Infinity API lets your platform pay people and businesses in other countries. You fund a wallet, register the payees you pay, and create payouts in each payee's currency. Infinity prices each payout, converts the funds, delivers them over the right local rail and reports every status change back to your server.

The API is organised around REST. It has predictable, resource-oriented URLs, accepts and returns JSON, authenticates each request with a secret key, and uses standard HTTP status codes. Anything you can do with payouts in the Infinity dashboard, you can do through the API; both operate on the same account and the same data.

## How money moves

```mermaid theme={null}
flowchart LR
  bank["Your bank account"] -- "bank transfer" --> wallet["Your Infinity wallet"]
  wallet -- "payout, converted" --> payee["Payee's bank account"]
  wallet -. "webhook events" .-> server["Your server"]
```

1. **Fund.** You send a bank transfer to one of your funding addresses. When it's credited to your wallet, Infinity records a deposit and emits `deposit.created`.
2. **Register payees.** A payee needs a payee address (their bank account) before money can reach them. You submit the bank details through the API, or the payee enters them on a hosted page.
3. **Pay.** One `POST /payouts` call creates up to 100 payouts. Infinity prices them, reserves the total in the wallet you choose, and sends each payout over its payee's rail.
4. **Track.** Every status change is recorded as an event and delivered to your webhook endpoints, so your system learns the outcome without polling.

## Core resources

| Resource | What it represents |
| - | - |
| Account | The business or individual sending payouts, and its settings: who pays fees and how long a payout can stay on hold. |
| Wallet | Funds held for you in one currency. You choose which wallet pays for each set of payouts. |
| Funding address | Bank details you transfer money to, to top up a wallet. |
| Deposit | A credit to one of your wallets. |
| Payee | A person or business you pay. |
| Payee address | The bank account a payee is paid into, with its rail (ACH, wire, SEPA, Faster Payments). |
| Quote | The price of one or more payouts at current rates. Quotes aren't stored. |
| Payout | A transfer of funds from a wallet to one payee. |
| Batch | The set of payouts created by one `POST /payouts` call, from 1 to 100. |
| Webhook endpoint | An HTTPS URL that receives events. |
| Event | An immutable record of one change, retained for 30 days. |

## Environments

The sandbox runs the same API as live against a simulated payout network, so you can build and test the whole integration without moving funds. The API key you send decides which environment a request runs in.

| | Sandbox | Live |
| - | - | - |
| Base URL | `https://sandbox-api.infinityapp.in/v1` | `https://api.infinityapp.in/v1` |
| Secret key | `sk_test_…` | `sk_live_…` |
| Funds | Simulated | Real |
| Payout timing | `paid` about 30 seconds after creation | Depends on the rail and the payee's bank |

Sandbox keys are issued by our team. [Contact us](mailto:support@infinityapp.in?subject=Sandbox%20API%20key) with your company name and we'll set up your sandbox account and send you an `sk_test_` key.

## Coverage

Infinity pays out in USD, EUR, GBP and INR today, and coverage is expanding. [Supported currencies](https://docs.infinityapp.in/guides/supported-currencies.md) lists each currency with its rails and limits. `GET /currencies` returns the currencies enabled for your account.

## The API and the dashboard

Payees and payouts you create through the API appear in your dashboard, and the other way round. Each `POST /payouts` call shows on the dashboard as one batch, under the `name` you give it.

## Next steps

> [card] [Quickstart](https://docs.infinityapp.in/guides/quickstart.md)
>
> Send your first payout in the sandbox.

> [card] [Authentication](https://docs.infinityapp.in/guides/authentication.md)
>
> Keys, environments and key rotation.

> [card] [Payouts](https://docs.infinityapp.in/guides/payouts.md)
>
> Creating payouts, statuses, holds and failures.

> [card] [API reference](https://docs.infinityapp.in/api-reference/payouts/create-payouts.md)
>
> Every endpoint, field and error code.


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