Update Scheduled Payout

PUT/payouts/v3/payments/banks/{paymentReferenceId}

Updates the scheduled date of a payout. Only payouts with status SCHEDULED can be updated. Provide the new schedule date in ISO 8601 UTC format.

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

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`paymentReferenceId`	`string`required	Unique identifier of the payment in Pine Labs database.

Request Body

Name	Type	Description
`scheduleAt`	`string`	New scheduled time for executing the payout (ISO 8601 UTC).

Response

Name	Type	Description
`clientReferenceId`	`string`	Unique identifier to track the payout.
`requestReferenceId`	`string`	Unique identifier of the request in Pine Labs database.
`paymentReferenceId`	`string`	Unique identifier of the payment in Pine Labs database.
`payeeName`	`string`	Name of the beneficiary.
`accountNumber`	`string`	Beneficiary's bank account number (may be masked).
`branchCode`	`string`	IFSC code of the beneficiary's bank.
`vpa`	`string`	VPA handle of the beneficiary (for UPI payouts).
`email`	`string`	Email address of the beneficiary.
`phone`	`string`	Mobile number of the beneficiary.
`amount`	`object`	Payout monetary amount with currency. For payout creation, minimum ₹1 (100 paisa), maximum ₹10 lakh (100000000 paisa).
`value`	`integer`required	Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).
`currency`	`string`required	Three-letter ISO 4217 currency code.
`mode`	`string`	Payment mode used for the payout. Allowed values: `UPIIMPSNEFTRTGS`
`status`	`string`	Current payout status. SCHEDULED: Request successfully received. PENDING: Funding account has insufficient balance. PROCESSING: Sent to bank, not yet processed. PROCESSED: Bank processed, confirmation pending. SUCCESS: Amount debited and credited successfully. FAILED: Transaction failed. Allowed values: `SCHEDULEDPENDINGPROCESSINGPROCESSEDSUCCESSFAILED`
`message`	`string`	Message corresponding to the payout status.
`scheduledAt`	`string`	Scheduled execution time in UTC. Empty string when cancelled.
`remarks`	`string`	Description or reference text for the transaction.
`_links`	`PayoutLink[]`	HATEOAS navigation links.
`rel`	`string`	Relation type of the link.
`href`	`string`	URL of the related resource.

Status Codes

`200`	Payout schedule updated successfully.
`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.
`404`	The requested resource does not exist.
`500`	An unexpected error occurred on the server.

Request

curl --request PUT \
  --url https://pluraluat.v2.pinepg.in/payouts/v3/payments/banks/%7BpaymentReferenceId%7D \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduleAt": "2025-07-05T16:05:00Z"
}'

Run this request

Bearer token

Path parameters

paymentReferenceId

Request body (JSON)

Status:

200 OK

{
  "clientReferenceId": "test4feb0-10",
  "requestReferenceId": "req-7c85bda19bf141c981b94e750c6041b6",
  "paymentReferenceId": "txn-f9e00a80a357418d908a67bd30cdbc37",
  "payeeName": "Rishendrasai",
  "accountNumber": "919000664016",
  "branchCode": "PYTM0123456",
  "vpa": "",
  "email": "s.john@g.com",
  "phone": "9000664016",
  "amount": {
    "currency": "INR",
    "value": 100
  },
  "mode": "IMPS",
  "status": "SCHEDULED",
  "message": "Payment instruction pending to be executed",
  "scheduledAt": "2025-07-05T16:05:00Z",
  "remarks": "Test transaction",
  "_links": [
    {
      "rel": "status",
      "href": "/payouts/v3/payments?paymentReferenceId=txn-f9e00a80a357418d908a67bd30cdbc37"
    }
  ]
}