Payout Status Enquiry

post

https://jtrapi.jiopay.co.in/bank-payout-v3-status

Check the current status of a previously initiated payout, looked up by custTxnRefNo, entityId and programId together. This returns the status currently recorded on JPSL's platform — it does not contact the bank. Use it as a reliable fallback if the callback notification is missed or delayed.

Every response is HTTP 200 OK, success or error alike — the outcome is in the response body's status and code fields. A different HTTP status is only returned when the API Gateway rejects the request before the API runs (see the Gateway-level responses below).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Payout Status Code

Payout Status Code	Meaning
REQUEST_RECEIVED	Request Received into the JPSL system
RECEIVED	Received - payout accepted and queued for later processing (deferred processing)
PENDING_FOR_AUTHORIZATION	Pending for Authorization - awaiting internal approval
APPROVED	Approved
REJECTED	A scheduler auto-rejects payouts that sat too long in PENDING_FOR_AUTHORIZATION/PENDING
REJECTED_BY_AUTHORISER	Rejected By Authoriser
PENDING_AT_BANK_MAKER	Pending At Bank Maker
PENDING_AT_BANK_CHECKER	Pending At Bank Checker
INITIATED	Initiated - sent to bank, no confirmation yet
PENDING_AT_BANK	Pending At Bank - sent to bank, awaiting confirmation
SUCCESS	Success - payout completed
FAILED	Failed - technical or bank-side failure
EXPIRED	Expired / front-end validation failure

Responses

200Every outcome of this endpoint — success and error alike — is returned as HTTP 200 OK. See status/code in the body for the actual result.

400The calling IP is not whitelisted for this API key.

401An Authorization: Bearer token was sent and is invalid or expired. Rejected by the API Gateway before the API runs.

403No API key in the request headers, or an invalid URL.

503Service unavailable.

504The upstream service provider endpoint did not respond in time (Gateway Timeout).