FinPay Ultra API Documentation

Introduction

Developer-first payments infrastructure

FinPay Ultra provides REST endpoints for recharge, BBPS bill fetch and payment, bank payout transfers, and NSDL PAN request workflows. Use secure API tokens from the partner dashboard before calling production services.

Company

FinPay Ultra

Website

finpayultra.com

Parent Company

Fintastix Business Solutions Pvt Ltd

Note: Replace sample tokens, operator codes, mobile numbers and request IDs with partner-specific production values.

Recharge API

Mobile, DTH and gift card recharge

Use this endpoint to initiate Mobile Recharge, DTH Recharge and Gift Card services with a unique reference transaction ID.

Purpose

Mobile, DTH & Gift Card Services

Method

GET

HTTP Code

200 with status in JSON

GET

https://ultra.myfinpaypro.co.in/api/Service/Recharge2?ApiToken=xxxxxxxx-xxx-xxx&MobileNo=8386900044&Amount=10&OpId=Operator_code&RefTxnId=Your_request_ID

Parameters

Parameter	Description
ApiToken	API Token
MobileNo	Customer Mobile Number
Amount	Recharge Amount
OpId	Operator Code
RefTxnId	Unique Request ID

Success Response

JSON

{
  "STATUS": 1,
  "MESSAGE": "Request is successfull!",
  "ERRORCODE": "0",
  "OPTXNID": "[Operator Txn ID]",
  "TXNNO": "[Our OrderID]",
  "REQUESTTXNID": "[Your_request_ID]",
  "HTTPCODE": 200
}

Failed Response

JSON

{
  "STATUS": 3,
  "MESSAGE": "Request is failed! - Error.",
  "ERRORCODE": "10",
  "TXNNO": "[Our OrderID]",
  "REQUESTTXNID": "[Your_request_ID]",
  "HTTPCODE": 200
}

Supported Services

Mobile Recharge
DTH Recharge
Gift Cards

BBPS API

Bill fetch and bill payment flows

BBPS integrations are split into Bill Fetch and Bill Payment endpoints. Fetch returns bill details; pay submits the payment request.

Section 1: Bill Fetch

GET

https://ultra.myfinpaypro.co.in/api/Service/BillFetch?at=xxxxxxx&num=mmm&acno=&acoth=&amt=1&op=23&rq=12942022&ez1=optional1&ez2=optional2&ez3=optional3

Bill Fetch Success Response

JSON

{
  "STATUS": 1,
  "MESSAGE": "Request is processed!",
  "REFID": "D220801184350504A51",
  "ERRORCODE": "0",
  "DATA": {
    "Bill_No": "10061",
    "Customer": "SH DEEPAK SHYAL",
    "Amount": 0.0,
    "DueDate": "21-07-2022",
    "BillPeriod": null,
    "BillDate": "11-07-2022"
  },
  "PRICE": "0",
  "HTTPCODE": 200
}

Bill Fetch Failed Response

JSON

{
  "STATUS": 3,
  "ERRORCODE": "20",
  "HTTPCODE": 200
}

Section 2: Bill Payment

GET

https://ultra.myfinpaypro.co.in/api/Service/BillPay?at=xxxxxxxx-xxx-xxx&op=88&num=20729&acno=&acoth=ACCOUNTOTHER&amt=596&rq=202286111214545132&ez1=optional1&ez2=optional2&ez3=optional3

Bill Payment Success Response

JSON

{
  "STATUS": 1,
  "MESSAGE": "Request is successfull!",
  "ERRORCODE": "0",
  "OPTXNID": "[Operator Txn ID]",
  "TXNNO": "[Our OrderID]",
  "REQUESTTXNID": "[Your_request_ID]",
  "HTTPCODE": 200
}

Bill Payment Failed Response

JSON

{
  "STATUS": 3,
  "MESSAGE": "Request is failed! - Error.",
  "ERRORCODE": "10",
  "TXNNO": "[Our OrderID]",
  "REQUESTTXNID": "[Your_request_ID]",
  "HTTPCODE": 200
}

Payout API

Bank account money transfer

Submit payout transfers to beneficiary bank accounts using a JSON POST body with account, IFSC, transfer mode and amount information.

Purpose

Bank Account Money Transfer

Method

POST

Transfer Mode

IMPS

POST

https://ultra.myfinpaypro.co.in/api/Service/MoneyTransfer

Input JSON

JSON

{
  "ApiToken": "Token",
  "orderId": "Agent ID",
  "beneficiaryAccount": "Account Number",
  "beneficiaryIFSC": "Bank_IFSC_Code",
  "amount": "Amount",
  "transferMode": "IMPS",
  "beneficiaryName": "",
  "OpId": "Operator_Code",
  "mobileno": "Mobile_number"
}

Success Response

JSON

{
  "STATUS": 1,
  "MESSAGE": "Request is successfull!",
  "ERRORCODE": "0",
  "OPTXNID": "[Operator Txn ID]",
  "TXNNO": "[Our OrderID]",
  "BENENAME": "",
  "REQUESTTXNID": "[Your_request_ID]",
  "EZYTMTXNID": "D220615423EA4215",
  "HTTPCODE": 200
}

Failed Response

JSON

{
  "STATUS": 3,
  "MESSAGE": "Request is failed! - Error.",
  "ERRORCODE": "10",
  "HTTPCODE": 200
}

NSDL PAN API

PAN request redirection APIs

Create New PAN, PAN Correction and Incomplete PAN redirection URLs for customer application flows.

1. New PAN Request

API

https://ultra.myfinpaypro.co.in/api/Mobile/NewPanRequestApi

Parameter	Description
TokenId	Partner token ID
Number	Customer mobile number
Mode	PAN request mode
Name	Applicant name
Email	Applicant email
Gender	Applicant gender
RefTxnId	Unique request ID

Success JSON

{
  "status": "Success",
  "message": "Pan Redirection url created",
  "url": "PAN_REDIRECTION_URL",
  "REQUESTTXNID": "Your_request_ID"
}

2. PAN Correction Request

API

https://ultra.myfinpaypro.co.in/api/Mobile/PanCorrectionRequestApi

Success JSON

{
  "status": "Success",
  "message": "Pan Redirection url created",
  "url": "PAN_REDIRECTION_URL"
}

3. Incomplete PAN Request

API

https://ultra.myfinpaypro.co.in/api/Mobile/IncompletePanRequestApi

Success JSON

{
  "status": "Success",
  "message": "Pan Redirection url created",
  "url": "PAN_REDIRECTION_URL"
}

Failure JSON

{
  "status": "Failure",
  "message": "Please enter correct Mobile number, it must be 10 digit"
}

Status Codes

Transaction lifecycle states

Use the STATUS field to evaluate the transaction result returned by each API response.

Code	Meaning
1	Success
2	Pending / Processing
3	Failed

Error Codes

Error code reference

Use ERRORCODE with STATUS and MESSAGE fields to identify authentication, transaction and bill fetch errors.

Code	Meaning
0	Success
1	Authentication Failed
10	Transaction Failed
20	Bill Fetch Failed

Support

Partner resources

Use the official website for company information and the partner login portal to access API credentials and merchant tools.

Website

https://finpayultra.com

Partner Login

Partner Portal

Brand Promise

Fintastix Business Solutions Pvt Ltd