GoterPay Partner API

GET/balance

Current wallet balance.

https://goterpay.in/api/balance?mid=..&mkey=..

{ "status": "SUCCESS", "balance": "24500.00", "message": "Success" }

GETPOST/recharge

Mobile / DTH / Google Play recharge.

https://goterpay.in/api/recharge?mid=..&mkey=..&operator=AT&number=1234567890&amount=199&txnid=ORD1001

https://goterpay.in/api/recharge?mid=..&mkey=..&operator=GPR&number=9876543210&amount=100&txnid=ORD1002

{ "txnid": "ORD1001", "status": "SUCCESS", "number": "1234567890",
  "amount": 199, "operator": "AT", "refid": "RB123456", "type": "Mobile",
  "balance": "24305.00", "commission": "4.975", "message": "Payment Processed" }

{ "txnid": "ORD1001", "status": "FAILED", "amount": 199,
  "balance": "24504.00", "commission": "0.000", "message": "Payment Failed" }

GET/mobileinfo

Mobile number ka operator + circle (GoterPay codes). Param: mobile.

https://goterpay.in/api/mobileinfo?mid=..&mkey=..&mobile=9004388135

{ "operator": "JO", "circle": "13", "status": "SUCCESS", "message": "SUCCESS" }

GET/Rplan

Operator + circle ke recharge plans. Params: operator, circle. Path /Rplan aur /rplan dono chalte hain.

https://goterpay.in/api/rplan?mid=..&mkey=..&operator=AT&circle=23

{ "status": "SUCCESS", "message": "Recharge Plan", "data": [
  { "type": "Unlimited", "details": "Unlimited + 1.5GB/day", "amount": "239", "talktime": "0", "validity": "28" } ] }

GET/Roffer

Number ke special offers. Params: operator, number. Path /Roffer aur /roffer dono chalte hain.

https://goterpay.in/api/roffer?mid=..&mkey=..&operator=AT&number=7797833489

{ "status": "SUCCESS", "message": "Recharge Offer", "data": [
  { "details": "Data : 30GB | Validity : 28 days", "amount": "200" } ] }

GET/dthinfo

DTH customer info by VC number. Params: operator, number.

https://goterpay.in/api/dthinfo?mid=..&mkey=..&operator=AD&number=3003451289

{ "status": "SUCCESS", "customerName": "R Kumar", "Balance": "120.00",
  "MonthlyRecharge": "300", "NextRecharge": "2026-08-01", "message": "DTH Info" }

GET/dthplan

DTH operator ke plans. Param: operator.

https://goterpay.in/api/dthplan?mid=..&mkey=..&operator=AD

{ "Status": "SUCCESS", "Message": "DTH Plan", "Data": [ … ] }

GET/dthcheck

VC number se DTH operator detect. Param: number.

https://goterpay.in/api/dthcheck?mid=..&mkey=..&number=00XXXXXXXX

{ "operator": "AD", "status": "SUCCESS", "message": "SUCCESS" }

GET/lastrecharge

Number ka last recharge amount + date. Params: operator, number.

https://goterpay.in/api/lastrecharge?mid=..&mkey=..&operator=AT&number=9004388135

{ "status": "SUCCESS", "amount": "239", "date": "2026-06-15", "message": "Last Recharge" }

GET/rechargeexpiry

Number ke plan ki validity. Outgoing = outgoing calls validity, Incoming = incoming validity. Params: operator, number.

https://goterpay.in/api/rechargeexpiry?mid=..&mkey=..&operator=AT&number=7797833489

{ "status": "SUCCESS", "expiry": "2026-08-25", "outgoing": "2026-08-25",
  "incoming": "2026-08-28", "message": "Recharge Expiry" }

GET/bill-fetch

BBPS bill fetch. Params: operator, number; optional optional1, optional2, optional3 (jab biller ko extra field chahiye — jaise mobile / a/c type).

Note: ye sirf BBPS billers ke liye hai. Recharge operators (Mobile / DTH / Google Play Recharge) ko bill fetch nahi — unhe seedha /recharge se process karo.

https://goterpay.in/api/bill-fetch?mid=..&mkey=..&operator=ELEC01&number=CONSUMER123&optional1=

{ "operator": "Adani Electricity", "status": "SUCCESS", "message": "",
  "dueAmount": "1630", "dueDate": "2021-06-14", "customerName": "Kamal Kanta",
  "billNumber": "1000149434", "billDate": "2021-05-24", "billPeriod": "MAY 21",
  "refid": "G84678282921", "editable": "false" }

GETPOST/bill-pay

BBPS bill payment. Params: operator, number, amount, txnid, refid (always required — har bill se pehle /bill-fetch karo, uska refid yahan bhejo); optional optional1-optional3.

https://goterpay.in/api/bill-pay?mid=..&mkey=..&operator=ELEC01&number=CONSUMER123&amount=540&txnid=BILL1001&refid=G84678282921&optional1=

{ "txnid": "BILL1001", "status": "SUCCESS", "number": "64767534", "amount": "1623",
  "vouchercode": "", "operator": "ADEM", "service": "ElectriCity", "balance": "60.00",
  "message": "Transaction success", "billamount": "1621", "commission": "2.500", "fees": "0.00" }

GET/status

Transaction status. Param: txnid (wahi id jo aapne recharge/bill-pay me bheji thi; requestid bhi accept hoti hai).

https://goterpay.in/api/status?mid=..&mkey=..&txnid=ORD1001

{ "txnid": "ORD1001", "status": "SUCCESS", "number": "1234567890",
  "amount": 199, "operator": "AT", "refid": "RB123456", "type": "Mobile", "commission": "4.975", "message": "Success" }

POST/payout

Payout to a bank account / UPI. POST JSON body (application/json). type: 1 = Bank, 2 = UPI. mode & ifsccode sirf type 1 ke liye. amount min 10, max 200000. txnid = aapka unique id.

POST https://goterpay.in/api/payout

{ "mid":"MID", "mkey":"MKEY", "type":"1", "mode":"IMPS", "name":"Pooja SenGupta",
  "account":"0123456789", "ifsccode":"KKBK0001351", "amount":"20",
  "txnid":"GP72456278", "callbackurl":"https://yourdomain.com/callback" }

{ "status": "PROCESSING", "txnid": "GP72456278", "amount": 20.00,
  "fee": 4.72, "message": "Payout Request Accepted" }

{ "status":"SUCCESS", "txnid":"GP72456278", "utrno":"521717440424",
  "bankacc":"0123456789", "ifsccode":"KKBK0001351", "name":"Pooja SenGupta",
  "amount":"20.00", "fees":"4.72", "date":"2025-08-05 11:42:40",
  "message":"Payment Transfer Success" }

POST/payout/status

Payout status. POST JSON body: mid, mkey, txnid.

POST https://goterpay.in/api/payout/status

{ "mid":"mid", "mkey":"mkey", "txnid":"GP72456278" }

{ "status":"SUCCESS", "txnid":"GP72456278", "utrno":"521717440424",
  "bankacc":"0123456789", "ifsccode":"KKBK0001351", "name":"Pooja SenGupta",
  "amount":"20.00", "fees":"4.72", "date":"2025-08-05 11:42:40",
  "message":"Payment Transfer Success" }

GETPOST/complaint

Raise a complaint. Params: txnid (ya requestid), message.

https://goterpay.in/api/complaint?mid=..&mkey=..&txnid=ORD1001&message=Not+received

{ "status": true, "message": "Complaint registered.", "complaintid": 42 }

GETPOST/complaint/status

Complaint status. Param: txnid. Response me complaint ke saath us order ki detail bhi aati hai: amount, number (recharge/billpay number) aur order_status (SUCCESS · PENDING · FAILED · REFUND).

https://goterpay.in/api/complaint/status?mid=..&mkey=..&txnid=ORD1001

{ "status": "OPEN", "complaintid": 42, "txnid": "ORD1001", "amount": "199.00",
  "number": "9004388135", "order_status": "SUCCESS", "reply": null }

POST/bankvalidate

Bank account + IFSC verify (penny-less/penny-drop). Params: accountno, ifsccode, txnid.

https://goterpay.in/api/verification/bankvalidate?mid=..&mkey=..&accountno=50100012345&ifsccode=HDFC0000123&txnid=VB1

{ "txnid":"VB1", "status":"SUCCESS", "AccountName":"GOTER WEB", "AccountNumber":"7797833489",
  "Fees":"3.00", "balance":"1000.00", "message":"Beneficiary Verification Success",
  "accountStatus":"VALID", "bank_name":"KOTAK MAHINDRA BANK LIMITED", "utr":"234345245",
  "city":"MUMBAI", "branch":"VEERA DESAI BRANCH", "micr":"400485064" }

POST/panvalidate

PAN verify. Params: pan, txnid.

https://goterpay.in/api/verification/panvalidate?mid=..&mkey=..&pan=ABCDE1234F&txnid=VP1

{ "txnid":"VP1", "status":"SUCCESS", "pan":"AAGCG1054K", "RegisteredName":"GOTER WEB",
  "FatherName":"", "type":"Company", "Fees":"3.00", "balance":"1563.24",
  "message":"PAN verified successfully" }

POST/aadhaarotp  +  POST/aadhaarverify

Aadhaar OTP-based verify (2 step). Fee OTP step par cut hoti hai, verify free. Step 1 params: aadhaar, txnid. Step 2 params: refid, otp, txnid.

https://goterpay.in/api/verification/aadhaarotp?mid=..&mkey=..&aadhaar=999999990019&txnid=OTP1

{ "txnid":"OTP1", "status":"SUCCESS", "refid":"3995593", "aadhaarno":"999999990019",
  "Fees":"3.00", "balance":"554.24", "message":"" }

https://goterpay.in/api/verification/aadhaarverify?mid=..&mkey=..&refid=3995593&otp=123456&txnid=VA1

{ "txnid":"VA1", "status":"SUCCESS", "refid":"3995593",
  "address":"Raiganj, West Bengal, 733156", "dob":"01-01-1960", "email":"", "mobile":"",
  "gender":"M", "name":"Kamal Kanta Mahato", "photo":"", "Fees":"0", "balance":"554.24",
  "message":"Aadhaar Card Exists" }

POST/gstvalidate

GSTIN verify. Params: gstin, txnid.

https://goterpay.in/api/verification/gstvalidate?mid=..&mkey=..&gstin=27ABCDE1234F1Z5&txnid=VG1

{ "txnid":"VG1", "status":"SUCCESS", "gstin":"27AAGCG1054K1ZL",
  "legalname":"GOTER WEB SERVICES (OPC) PRIVATE LIMITED", "tradename":"GOTER WEB SERVICES (OPC) PRIVATE LIMITED",
  "centerjurisdiction":"RANGE-II", "statejurisdiction":"ANDHERI-WEST_704", "registration":"2019-11-20",
  "taxpayer":"Regular", "gstinstatus":"Active", "address":"ANDHERI WEST, Maharashtra, 400058",
  "type":"Private Limited", "Fees":"3.00", "balance":"557.24", "message":"GSTIN Exists" }

GET/ifscvalidate

IFSC details. Params: ifsc, txnid. data = JSON-string (bank/micr/city/branch/neft/imps/rtgs/upi…).

https://goterpay.in/api/verification/ifscvalidate?mid=..&mkey=..&ifsc=HDFC0000123&txnid=5645

{ "txnid":"5645", "status":"SUCCESS",
  "data":"{\"bank\":\"RBL BANK LIMITED\",\"ifsc\":\"RATN0000346\",\"neft\":\"Live\",\"imps\":\"Live\",\"rtgs\":\"Live\",\"upi\":\"Live\",\"micr\":400176046,\"city\":\"MUMBAI\",\"state\":\"MAHARASHTRA\",\"branch\":\"SV ROAD, ANDHERI WEST\"}",
  "Fees":"1.00", "balance":"100.84", "message":"Beneficiary Verification Success" }

POST/upivalidate

UPI / VPA verify. Params: vpa, txnid.

https://goterpay.in/api/verification/upivalidate?mid=..&mkey=..&vpa=name@@okhdfcbank&txnid=VU1

{ "txnid":"VU1", "status":"SUCCESS", "AccountName":"Kamal Kanta Mahato",
  "vpa":"name@@okhdfcbank", "Fees":"3", "balance":"234235", "message":"Payment Transfer Success" }

POST/dlvalidate

Driving licence verify. Params: dlno, dob, txnid.

https://goterpay.in/api/verification/dlvalidate?mid=..&mkey=..&dlno=DL0420110012345&dob=1990-01-01&txnid=VD1

{ "txnid":"VD1", "status":"SUCCESS", "dl_no":"DL0420110012345",
  "validity_to":"2039-04-17", "validity_from":"2019-04-18", "issue_date":"2019-04-18",
  "vehicle_manufacturer_name":null, "name":"...", "father_or_husband_name":"...",
  "complete_address":"", "address":"", "dl_status":"ACTIVE",
  "Fees":"3.00", "balance":29.84, "message":"DL Verification Success" }

POST/rcvalidate

Vehicle RC verify. Params: rcno, txnid.

https://goterpay.in/api/verification/rcvalidate?mid=..&mkey=..&rcno=MH01AB1234&txnid=VR1

{ "txnid":"VR1", "status":"SUCCESS", "vehicle_manufacturer_name":"RENAULT INDIA PVT LTD",
  "model":"KWID RXT 1.0", "vehicle_colour":"ICE COOL WHITE", "type":"PETROL",
  "body_type":"HATCHBACK", "owner_count":"2", "rc_status":"ACTIVE", "reg_date":"2019-06-27",
  "rc_expiry_date":"2034-06-26", "vehicle_number":"MH02FE3662", "is_commercial":false,
  … (reg_authority, insurance, pucc, permit, weights, etc.) …
  "Fees":"3.00", "balance":44.84, "message":"Beneficiary Verification Success" }

POST/votervalidate

Voter ID verify. Params: epic, txnid.

https://goterpay.in/api/verification/votervalidate?mid=..&mkey=..&epic=ABC1234567&txnid=VV1

{ "txnid":"VV1", "status":"SUCCESS", "epic_number":"...", "name":"...", "age":"...",
  "relation_name":"...", "relation_type":"...", "gender":"...", "address":"...", "state":"...",
  "assembly_constituency":"...", "parliamentary_constituency":"...", "part_number":"...",
  "serial_number":"...", "polling_station":"...", "Fees":"3.00", "balance":23.84,
  "message":"Voter id Verification Success" }

POST/cinvalidate

Company CIN verify. Params: cin, txnid.

https://goterpay.in/api/verification/cinvalidate?mid=..&mkey=..&cin=U72200MH2010PTC201234&txnid=VC1

{ "txnid":"VC1", "status":"SUCCESS", "cin":"U74900WB2015OPC207754",
  "company_name":"GOTER WEB SERVICES (OPC) PRIVATE LIMITED", "registration_number":207754,
  "incorporation_date":"2015-09-09", "cin_status":"ACTIVE", "email":"kamalkanta23@gmail.com",
  "incorporation_country":"INDIA",
  "director_details":[ { "din":"07270706", "name":"KAMALKANTA MAHATO", "designation":"DIRECTOR",
    "dob":"1990-**-**", "address":"*****, WEST BENGAL, INDIA, 733156" } ],
  "Fees":"3.00", "balance":20.84, "message":"CIN Verification Success" }

Panel mein callback URL set karo (Settings → Webhook). Recharge/bill-pay finalise hone par hum GET bhejte hain:

Recharge / DTH operators

Recharge / DTH ke operator param mein ye OperatorCode bhejo.

⇩ Download Excel (CSV)

BBPS / Utility billers

BBPS ke operator param mein ye OperatorCode bhejo. Number column = number param mein kya bhejना hai; Optional1 column = optional1 param ka label/hint (jo value bhejni hai).