Look up a remitter by mobile number and read the available registration, KYC, limits and beneficiary details.

Endpoint

POST https://pay2new.in/apis/dmt/v2/remitterProfile

Authentication

Send both headers on every request:

📘

Account and outlet access

Use an IP address registered on your partner account. The partner account, KYC, wallet, API access and DMT service must be active. The outlet must be enabled for this service.

Send an actual JSON object with Content-Type: application/json.

Request

Use this response to decide the next step. A remitter-not-found result can use status: 3; it does not mean that a money transfer is pending.

Example request

The values below are synthetic. Replace the credential, outlet ID, response references and customer details before sending a request.

curl --request POST \
  --url 'https://pay2new.in/apis/dmt/v2/remitterProfile' \
  --header 'secret: YOUR_PAY2NEW_SECRET' \
  --header 'outletId: YOUR_PAY2NEW_OUTLET_ID' \
  --header 'Content-Type: application/json' \
  --data '{
  "mobile": "9000000001"
}'

Response

Read the JSON status and message even when the HTTP request completes successfully.

The response data may include the next reference or action. Preserve returned references exactly; do not assume every response has the same nested fields.

📘

OTP and next steps

1 indicates success for the current step, 2 indicates rejection or failure, and 4 means an OTP was sent and the matching verification step is still required. Inspect the message and response data for the next step. A remitter-not-found response may use 3; begin the registration flow rather than treating it as a pending funds transfer.

Rejections

A missing secret header returns status: 2 and message: "Secret Header not found!". Missing outletId returns "Outlet ID not found!"; an unavailable outlet returns "Invalid OutletId". Invalid or missing JSON returns "Invalid Json!". Field validation failures return "Invalid Parameters" with an errors object containing the field messages. Application failures can be returned in an HTTP-success response.

{
  "status": 2,
  "message": "Invalid Json!"
}

Service-specific response fields and behaviour

Response examples for this operation

Synthetic examples adapted to the Pay2New wrapper. Reference tokens and dates are placeholders. Provider data can omit fields depending on the outcome; the application status and current returned references control the next step.

Registered remitter

{
  "status": 1,
  "message": "Success",
  "data": {
    "mobileNumber": "9000000001",
    "firstName": "Sample",
    "lastName": "Customer",
    "city": "Pune",
    "pincode": "411001",
    "limitPerTransaction": 5000,
    "limitTotal": "25000.00",
    "limitConsumed": "0.00",
    "limitAvailable": "25000.00",
    "limitDetails": {
      "maximumDailyLimit": "25000.00",
      "consumedDailyLimit": "0.00",
      "availableDailyLimit": "25000.00",
      "maximumMonthlyLimit": "25000.00",
      "consumedMonthlyLimit": "0.00",
      "availableMonthlyLimit": "25000.00"
    },
    "beneficiaries": [
      {
        "id": "SAMPLE_BENEFICIARY_ID",
        "name": "Sample Beneficiary",
        "account": "000123456789",
        "ifsc": "TEST0000001",
        "bank": "SAMPLE BANK",
        "beneficiaryMobileNumber": "9000000002",
        "verificationDt": "2026-09-26 17:00:00"
      }
    ],
    "isTxnOtpRequired": true,
    "isTxnBioAuthRequired": false,
    "isImpsAllowed": true,
    "isNeftAllowed": true,
    "isFaceAuthAvailable": false,
    "validity": "2026-09-26 18:15:00",
    "referenceKey": "REFERENCE_FROM_THIS_RESPONSE",
    "pidOptionWadh": "WADH_FROM_CURRENT_PROFILE"
  },
  "order_id": null
}

Remitter not found

{
  "status": 3,
  "message": "Remitter Not Found",
  "data": {
    "validity": "2026-09-26 18:15:00",
    "referenceKey": "REFERENCE_FROM_THIS_RESPONSE",
    "isTxnOtpRequired": true,
    "isTxnBioAuthRequired": false,
    "isImpsAllowed": true,
    "isNeftAllowed": true,
    "isFaceAuthAvailable": false,
    "pidOptionWadh": "WADH_FROM_CURRENT_PROFILE"
  },
  "order_id": null
}

Invalid outlet

{
  "status": 2,
  "message": "Invalid OutletId"
}

Service unavailable

{
  "status": 2,
  "message": "Oops, This service is not for you!"
}

Validation error

{
  "status": 2,
  "message": "Invalid Parameters",
  "errors": {
    "mobile": "This required field is missing or invalid."
  }
}

📘

Next step

If the remitter is not found, continue Registration with the returned current reference. Otherwise inspect KYC/limits and refresh references before the next step.

See the DMT Integration Flow for all endpoints and Webhook Information for transaction notifications.

Pay2New exposes only status, message, data and order_id: null on a provider-backed result. Upstream statuscode, actcode, timestamp, ipay_uuid, orderid and environment are not top-level fields in this API. Early errors can omit data/order_id.

Provider data-field reference: Instantpay Remitter Profile. Use the Pay2New method, headers and request field names on this page; upstream examples use a different envelope.