Get the active circle codes and names used by mobile recharge plan APIs.

Endpoint

GET https://pay2new.in/apis/v1/circleList

Headers

📘

Authentication

Use an active Pay2New partner account with verified KYC, an active wallet and API access. Send requests from your registered IP address. Enable the relevant service where applicable; offer services may also require an active plan.

Request

This endpoint does not require a request body.

Request example

📘

Illustrative values

All identifiers, identity data, amounts and IP addresses in these examples are synthetic. Replace the secret, product/customer references and sample inputs with the values for your integration before sending a request.

curl --request GET \
  --url 'https://pay2new.in/apis/v1/circleList' \
  --header 'secret: <YOUR_PAY2NEW_SECRET>'

Response fields

Response example

{
  "status": 1,
  "message": "Transaction Successful!",
  "data": [
    {
      "circle_code": "1",
      "circle_name": "Example circle"
    }
  ]
}

📘

Integration notes

Treat returned identifiers as codes. Use the values returned for your account rather than copying the illustrative IDs in this page.

Errors

Application failures return status: 2 and a message. Invalid fields can also be identified in an errors object. Authentication, IP registration, service access and product availability can prevent processing. Other response fields may be absent when processing fails before a transaction is created. Evaluate the JSON result even when the HTTP request completes successfully. Preserve your request and order references when an outcome is pending or indeterminate.

{
  "status": 2,
  "message": "Secret Header not found!"
}