Settlement Account List

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

List settlement accounts registered for the outlet.

GET https://pay2new.in/apis/aeps/v1/accountList

Headers

HeaderRequiredDescription
secretYesYour Pay2New API secret.
outletIdYesPay2New outlet/customer ID returned after successful onboarding; do not send the provider outlet ID.
AcceptNoRequest 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

  • An empty account list returns status 2 with message No bank accounts founds.
  • Use the returned account id for Settlement Delete Account.

Response

Application status is returned in the JSON status field. A successful HTTP response alone does not confirm a successful operation.

FieldDescription
statusinteger: application status, not HTTP status
messagestring
dataarray of {id, account_holder_name, account_number, ifsc, bank, is_verified, instantpay_status}

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": [
    {
      "id": "123",
      "account_holder_name": "Example Merchant",
      "account_number": "000000000001",
      "ifsc": "ABCD0123456",
      "bank": "Example Bank",
      "is_verified": 1,
      "instantpay_status": "added"
    }
  ]
}

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!"
}
Headers
string
required

Your Pay2New API secret.

string
required

Pay2New outlet/customer ID returned after successful onboarding; do not send the provider outlet ID.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json