Skip to main content
The bluSwap Payouts API lets you send funds to verified beneficiaries through bank transfers or UPI. Use Payouts whenever your business needs to pay a vendor, customer, employee, or partner. You first register the beneficiary as a contact, confirm their verification status, then initiate the transfer from one of your virtual accounts.

How it works

1

Create and verify a contact

Create a beneficiary using bank account details, a UPI ID, or both. Wait until the contact status is VERIFIED before attempting a payout.
2

Select a virtual account

Retrieve an active virtual account and use its va_id in the payout request. Each payout is debited from the virtual account you specify.
3

Initiate / Check payout status

Send the payout with a unique order_id. Confirm its final status through callbacks or the status endpoint.

Supported payout methods

Before sending funds

Review the following checklist before you process live payouts:
  • Only contacts with status VERIFIED can receive payouts. Use a unique order_id for each payout request to prevent duplicate disbursements.
  • Configure callbacks before processing live payouts so you receive real-time status updates for every transaction.
  • Store the payout status and reference IDs from each response for reconciliation and audit purposes.
Only contacts with status VERIFIED can receive payouts. Payout requests to unverified contacts will be rejected.

Next steps

Create Contact

Register a new beneficiary with bank account or UPI details.

Get Virtual Account

Retrieve your active virtual accounts and their va_id values.

Initiate Payout

Send funds to a verified contact from a virtual account.

Webhook Configuration

Set up callbacks to receive real-time payout status updates.