| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Retrieve the payout bank list.
GET https://pay2new.in/apis/payout/v1/BankList
Headers
| Header | Required | Description |
|---|---|---|
secret | Yes | Your Pay2New API secret. |
Accept | No | Request a JSON response. |
Requests require an active partner account, approved KYC, active wallet and API access, an allowlisted source IP, and the relevant service enabled.
No request body is required.
Usage notes
- Requires an enabled payout service. The route name is case-sensitive: BankList.
Response
Application status is returned in the JSON status field. A successful HTTP response alone does not confirm a successful operation.
| Field | Description |
|---|---|
status | integer: application status, not HTTP status |
message | string |
data | array of {BankId, name, iin} |
order_id | null |
Provider-dependent fields may be absent or null. status: 2 indicates a failure. For transaction endpoints, status: 3 indicates pending or uncertain processing and requires status confirmation.
Illustrative response:
{
"status": 1,
"message": "Success",
"data": [
{
"BankId": "123",
"name": "Example Bank",
"iin": "000000"
}
],
"order_id": null
}
Errors
Validation errors can include an errors object keyed by field name. Authentication, outlet, service and other processing errors can return only status and message. Errors are application-level responses; do not rely on an HTTP 400 status.
{
"status": 2,
"message": "Secret Header not found!"
}
