Pine LabsDOCS

Create Bulk Payouts

POST/payouts/v3/payments/banks/file

Creates multiple payouts in bulk by uploading a file containing beneficiary account details. The file is processed asynchronously. Use the Get Payouts API with the returned requestReferenceId to track individual payout statuses.

Requires Bearer token. Get token →

Request Body

NameTypeDescription
file
stringrequired

File containing beneficiary account details for bulk payout processing.

Status Codes

201Bulk payout file accepted and processing initiated.
400The request was malformed or missing required fields.
401Authentication failed — missing, expired, or invalid Bearer token.
403The authenticated client does not have permission for this operation.
500An unexpected error occurred on the server.
Request
curl --request POST \
  --url https://pluraluat.v2.pinepg.in/payouts/v3/payments/banks/file \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data file=your_file

Run this request

201 Created
{
  "requestReferenceId": "req-1b980dd2c75b456782bc1a3acff481a0",
  "status": "PROCESSED",
  "message": "",
  "_links": [
    {
      "rel": "status",
      "href": "/payouts/v3/payments?requestReferenceId=req-1b980dd2c75b456782bc1a3acff481a0"
    }
  ]
}