Pine LabsDOCS
Create Account

API Playground

Test Pine Labs API endpoints with real requests. All endpoints are loaded dynamically from the OpenAPI specification.

Create Payout API

Creates a single payout to a beneficiary's bank account or UPI VPA. Supports IMPS, NEFT, RTGS, and UPI payment modes. For IMPS/NEFT/RTGS, provide accountNumber and branchCode. For UPI, provide vpa instead.

POSThttps://pluraluat.v2.pinepg.in/payouts/v3/payments/banks
Required
Request Body (editable JSON)
Request Body Schemarequired
FieldDetails
clientReferenceId
stringrequiredidempotency key

Unique identifier to track the payout. Must not contain spaces. **Acts as the idempotency key** — duplicate requests with the same `clientReferenceId` will not create a new payout.

Constraints
Minimum length: 1 characterMaximum length: 40 characters
payeeName
stringrequired

Name of the beneficiary's bank account holder. Alphabets and spaces only.

Constraints
Minimum length: 1 characterMaximum length: 40 characters
email
stringemail

Email address of the beneficiary.

phone
string

Mobile number of the beneficiary (10 numeric digits).

Constraints
Pattern: ^[0-9]{10}$
accountNumber
string

Beneficiary's bank account number. Mandatory for IMPS, NEFT, and RTGS.

Constraints
Minimum length: 9 charactersMaximum length: 18 characters
branchCode
string

Beneficiary's bank IFSC code. Mandatory for IMPS, NEFT, and RTGS. First 4 characters alphabets, 5th character must be 0, remaining alphanumeric.

Constraints
Maximum length: 11 characters
amount
objectrequired2 nested fields

Payout monetary amount with currency. For payout creation, minimum ₹1 (100 paisa), maximum ₹10 lakh (100000000 paisa).

value
integerrequired

Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).

Constraints
Minimum value: 100Maximum value: 100000000
currency
stringrequired

Three-letter ISO 4217 currency code.

Constraints
Default value: INR
mode
stringrequired

Mode of payment for the payout.

Allowed values
UPIIMPSNEFTRTGS
remarks
stringrequired

Description or reference text for the transaction. Supported characters A-Z, a-z, 0-9, hyphen, space.

Constraints
Minimum length: 1 characterMaximum length: 50 characters