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.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

Field	Details
`file` `string`requiredbinary	File containing beneficiary account details for bulk payout processing.

Status Codes

`201`	Bulk payout file accepted and processing initiated.
`400`	The request was malformed or missing required fields.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`403`	The authenticated client does not have permission for this operation.
`500`	An unexpected error occurred on the server.

Run

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' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data file=your_file

Status:

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