Introduction

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

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

Quickstart

Send your first payout in the sandbox.

Authentication

Keys, environments and key rotation.

Payouts

Creating payouts, statuses, holds and failures.

API reference

Every endpoint, field and error code.

Get started

Concepts

Build reliably