India payout

🧪

The India corridor is still in beta so you might notice occasional instability as we fine-tune things. We’ll be rolling out updates regularly and your feedback is invaluable in helping us get it right!

Payment Account Types

The supported payment account types in India are:

  • ALIAS
  • BANK_ACCOUNT_ROUTE

Alias

The supported alias network in India is:

  • UPI

We support payouts via UPI (Unified Payments Interface) in India. To initiate a payout, provide UPI as the ALIAS network and the recipient’s UPI ID (Virtual Payment Address) as the ALIAS identifier.

Bank Account Route

We support payouts to banks in India using the bank’s IFSC (Indian Financial System Code) instead of a bank_id. Each IFSC uniquely identifies the bank, and branch, ensuring payments are routed accurately to the intended destination. Unlike other markets, we do not maintain or return a list of available IFSCs at the list banks endpoint for India as there are thousands of codes across the country.

Decimal Requirements

Payment Account TypeDecimals Allowed
ALIAS (UPI)2
BANK_ACCOUNT_ROUTE2

Transaction Limits

Payment Account TypeMinimum Amount (INR)Maximum Amount (INR)
ALIAS (UPI)1200,000
BANK_ACCOUNT_ROUTE11,500,000

Compliance Requirements

FieldRequirements
purposeRequired (please refer our list of pre-determined allowed values in Payouts)
sender.typeRequired
sender.nameRequired
sender.address.line1Required
sender.address.cityRequired
sender.address.postal_codeRequired
sender.address.countryRequired
sender.individual.dobRequired (with type INDIVIDUAL)
sender.individual.identity_document.typeRequired (with type INDIVIDUAL)
sender.individual.identity_document.countryRequired (with type INDIVIDUAL)
sender.individual.identity_document.numberRequired (with type INDIVIDUAL)
sender.individual.identity_document.expires_onRequired (with type INDIVIDUAL)

Sample payload

The samples below are specific to India and based off the local regulations.

For a more Comprehensive list of fields, see the Payout resource.

ℹ️

Info: To send payouts via UPI (Unified Payments Interface) in India, provide UPI as the alias.network and the recipient’s UPI ID (Virtual Payment Address) as the alias.identifier.

{
  "amount": {
    "currency": "INR",
    "value": "1000"
  },
  "payment_account": {
    "type": "ALIAS",
    "country": "IN",
    "holder": {
      "type": "INDIVIDUAL",
      "name": "Neha Patel"
    },
    "alias": {
      "network": "UPI",
      "identifier": "neha.patel@ybl"
    }
  },
  "purpose": "REMITTANCE",
  "sender": {
    "type": "INDIVIDUAL",
    "name": "Mario Rossi",
    "address": {
      "line_1": "Piazza del Colosseo",
      "line_2": "1",
      "line_3": "",
      "city": "Roma",
      "postal_code": "00184",
      "country": "IT"
    },
    "individual": {
      "dob": "1985-06-15",
      "identity_document": {
        "type": "PASSPORT",
        "country": "IT",
        "number": "YA0000000",
        "expires_on": "2030-01-01"
      }
    }
  }
}