IMB Developer

Introduction

IMB Payout API Documentation

Overview:

The IMB Payout API allows developers to integrate payout functionality into their applications, enabling them to automate and streamline the process of making financial transactions to recipients. The API provides a secure and reliable way to initiate and manage payouts, facilitating seamless transfer of funds to individuals or organizations.

Key Features:

Payout Initiation: The API enables developers to initiate payouts to designated recipients through a simple and intuitive interface. Developers can specify the recipient details, such as name, email address, bank account information, or other relevant details required for the payout. Payment Methods: The IMB Payout API supports various payment methods, including bank transfers, electronic wallets, and other popular payment gateways, providing flexibility to developers and end-users alike.
Security and Compliance: IMB places a strong emphasis on security and compliance. The Payout API incorporates industry-standard security measures, such as encryption and authentication protocols, to ensure the confidentiality and integrity of sensitive financial information. Payout Status Tracking: Developers can easily track the status of initiated payouts through the API. Real-time updates and notifications enable them to keep users informed about the progress and completion of their payout requests.
Error Handling and Reporting: The API provides comprehensive error handling and reporting capabilities. It offers detailed error codes and messages, allowing developers to identify and troubleshoot any issues that may arise during payout processing.

Documentation and Support: The IMB Payout API documentation offers clear and concise instructions on how to integrate the API into various platforms and programming languages. It includes code samples, tutorials, and reference materials to assist developers throughout the implementation process. Additionally, IMB provides dedicated support channels, including forums and developer resources, to address any questions or concerns that may arise.

Integration Examples:

E-commerce Platforms: Developers can integrate the IMB Payout API into e-commerce platforms, enabling seamless disbursements of funds to vendors, suppliers, or affiliate partners. Gig Economy Applications: Payout functionality can be integrated into gig economy applications, allowing businesses to easily distribute earnings to their freelance workforce or service providers.
Financial Services: The API can be utilized by financial institutions and fintech companies to facilitate quick and secure payouts to their customers, such as insurance claim settlements or loan disbursements. Crowdfunding Platforms: Crowdfunding platforms can leverage the IMB Payout API to distribute funds to project creators or beneficiaries, streamlining the payout process and enhancing user experience.

By leveraging the IMB Payout API, developers can empower their applications with efficient and reliable payout capabilities, simplifying financial transactions and enhancing user satisfaction.

Header Token Security:


	CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIEJyaE02Q0UxdHhMRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l5'
  )

Features of the IMB Payout API:

Payout Initiation: Initiate payouts to recipients with ease.
Payment Methods: Support for various payment methods, including bank transfers and electronic wallets.
Security and Compliance: Strong security measures and compliance with industry standards.
Payout Status Tracking: Real-time updates on the status of initiated payouts.
Error Handling and Reporting: Comprehensive error handling and reporting capabilities.
Documentation and Support: Clear and concise documentation and dedicated support channels.

Payout Transaction API

this is the transaction api of payout send the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/api/v1/payout/doTxn

Method: POST

Request Parameters:

sender_name	Payment Sender Name/Owner Name
bank_name	Bank Name
account	Bank Account Number
ifsc	IFSC Code
payment_mode	5-IMPS, 4-NEFT , 13-RTGS
amount	Amount in INR Ex.100
customer_name	Bank Account Holder Name
refrence	Your Unique Transaction id
account_type	1-Saving, 2-Current
tag	Remarks Ex.Gift,Grocry,etc

Request Json:

{
    "sender_name" : "IMB",
    "account" : 5172262849,
    "bank_name" : "STATE BANK OF INDIA",
    "ifsc" : "CBIN0281281",
    "payment_mode" : 4,
    "amount" : 200,
    "customer_name" : "IMB Test",
    "refrence" : "TXNI87687687",
    "account_type" : 1,
    "tag" : "Gift"
}

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/payout/doTxn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "sender_name" : "IMB",
    "account" : 5172262849,
    "bank_name" : "STATE BANK OF INDIA",
    "ifsc" : "CBIN0281281",
    "payment_mode" : 4,
    "amount" : 200,
    "customer_name" : "IMB Test",
    "refrence" : "TXNI87687687",
    "account_type" : 1,
    "tag" : "Gift"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111 = initiated ,112= Success, 113= Fail

{
    "response_code": 111,
    "message": "Transaction initiated successfully",
    "RequestId": "TXNI87687687",
    "data": {
        "customerName": "Imb Test",
        "account": 5172262849,
        "ifsc": "CBIN0281281",
        "accType": 1,
        "txn_id": "35435563240807",
        "reference_id": "TXNI87687687",
        "amount": 200,
        "charge": 0,
        "gst": 0,
        "closing_wallet": 1400.00,
        "remark": "Gift",
        "payment_mode": "IMPS",
        "status": "Initiated",  // Status : Initiated,Success,Fail
        "message": "Transaction initiated successfully"
    }
}

Check Status API

this is the check status api of payout transaction the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/api/v1/payout/CheckStatus

Method: POST

Request Parameters:

refId	your reference id of transaction

Request Json:

{
    "refId" : "TXN22395476" // Your Reference id
}

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/payout/CheckStatus',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "refId" : "TXN22395476"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111 = Initiated,112= Success, 113= Fail,Reversed(Refund)

{
    "response_code": 113,
    "message": "Sucess! Enquiry success.",
    "RequestId": "txn1008984587",
    "data": {
        "account": "51660100005655",
        "ifsc": "BARB0GBROAD",
        "reference_id": "txn1008984587", // Your reference id
        "amount": "100.00",
        "payment_mode": "IMPS",
        "status": "Reversed",
        "message": "Sucess! Enquiry success."
    }
}

Callback URL Setup For Payout API.

Dear Partners, You must Add an endpoint for callback APIs. This endpoint will be used by IMB to update the transaction status. We will assume that the update request has been acknowledged upon receiving a status 200 “Success” from the endpoint.

Note that only static URL structures are supported.

URL STRUCTURE: https://domain.in/path

Method: POST

We will send the following payload when we hit your API:

Response Code	111,112= Success, 113= Fail,Reversed(Refund)


{
    "event": "PAYOUT_STATUS_UPDATE",
    "message": "Transaction Successfull",
    "data": {
        "txn_id": "35435563240807",
        "status": "Success", // Success,Fail,Reversed
        "amount": "200.00",
        "payment_mode": "IMPS",
        "account_type": NULL,
        "client_ref_id": "TXNI87687687",
        "utr_no": "536536587353",
        "ifsc": "CBIN0281281",
        "recipient_name": "IMB Test",
        "account": "5172262849",
        "timestamp": "25-07-2020 10:32:00 GMT"
    }
}

Introduction

IMB Payment Gateway API Documentation

IMB Payment Gateway Overview:

The IMB Payment Gateway is a comprehensive solution designed to help businesses and developers easily integrate secure payment processing into their applications or websites. With a focus on flexibility, security, and reliability, the IMB Payment Gateway offers a wide range of features to facilitate seamless transactions, allowing merchants to accept payments from customers through multiple channels.

Key Features:

Multi-Channel Payment Support: IMB Payment Gateway allows businesses to accept payments from various methods, including credit cards, debit cards, net banking, UPI, electronic wallets, and more. This gives customers the flexibility to choose their preferred payment method, enhancing user satisfaction and conversion rates. Secure Transactions: Security is at the forefront of IMB's services. The payment gateway uses advanced encryption techniques, two-factor authentication, and industry-standard protocols such as PCI-DSS compliance to safeguard customer data and ensure secure transaction processing. Fraud detection mechanisms are also in place to protect both merchants and customers from potential risks. Real-Time Payment Tracking: Merchants can easily track the status of payments in real-time, enabling better transaction management and customer support. Detailed reports are available, offering insights into transaction history, refunds, and failed payments. Global Payment Capabilities: IMB Payment Gateway supports international payments, enabling businesses to reach a global audience and accept payments in multiple currencies. This feature is particularly beneficial for businesses looking to expand their reach beyond local markets. Seamless Integration: The IMB Payment Gateway offers developers easy integration options with various platforms, such as e-commerce websites, mobile apps, and point-of-sale systems. The API is well-documented with clear instructions and code samples, allowing for quick setup and customization. Customizable Checkout Experience: The payment gateway offers a customizable checkout page that can be tailored to match the branding and design of the business, providing a seamless and familiar experience for customers during the payment process. Dedicated Support: IMB provides robust support to its users, with a dedicated team available to help resolve any technical issues or questions. Their developer resources, forums, and support channels ensure a smooth integration process and reliable ongoing service.

Integration Examples:

E-Commerce Stores: IMB Payment Gateway can be easily integrated into online stores, allowing businesses to accept payments from customers worldwide and manage transactions efficiently. Subscription Services: Businesses that offer subscription-based services can use the payment gateway to handle recurring payments securely and efficiently, ensuring seamless operations for both the provider and the customer. Mobile Applications: Developers building mobile apps can integrate IMB Payment Gateway to provide users with a fast, reliable, and secure way to make payments within the app, whether for purchasing goods or accessing premium features. Non-Profit Organizations: Charitable organizations can leverage IMB Payment Gateway to accept donations from across the globe, ensuring that all transactions are securely processed and tracked. With the IMB Payment Gateway, businesses can enhance their payment processing capabilities, providing customers with a seamless and secure experience while ensuring smooth financial transactions.

Features of the IMB Payment Gateway API:

Register easily with IMB Payment Gateway and activate your account instantly
You can accept payments by linking any UPI merchant to IMB Payment Gateway
If you want to accept payments through IMB Payment Gateway without linking it to any merchant, you can do so.
You can accept payments through IMB Payment Gateway with zero transaction and instant settlement
Accept payment from IMB Payment Gateway without any worry as it is 100% secure
IMB does not provide any branding of the payment gateway, hence use it by integrating it on your website.

Create Order API

The order is created through this API. Once the order is created, you will get a payment link. You can accept the payment very easily by redirecting to the same payment link.

URL: https://pay.imb.org.in/api/create-order

Form-Encoded Payload (application/x-www-form-urlencoded)

Request Parameters:

customer_mobile	Your customer's mobile number will be here
user_token	Here you will find the API token of Imb payment gateway
amount	Your transaction amount here
order_id	Enter the unique transaction ID here.
redirect_url	Enter your redirect URL here, on payment success or faild it will redirect you to this URL
remark1	Enter your customer's email address so they can receive notification of their payment
remark2	Here you can send any details or data as per your requirement.

Request:

{
  "customer_mobile": "9876543210",
  "user_token": "940149cb99886d365f5f314476a994b6",
  "amount": "1",
  "order_id": "8787772321800",
  "redirect_url": "https://pay.imb.org.in",
  "remark1" : "[email protected]",
  "remark2" : "Hello",
}

Success Response:

 {
    "status": true,
    "message": "Order Created Successfully",
    "result": {
        "orderId": "1234561705047510",
        "payment_url": "https://pay.imb.org.in/payment/pay.php?data=MTIzNDU2MTcwNTA0NzUxMkyNTIy"
    }
}

Failed Response:

{
    "status": "false",
    "message": "Order_id Already Exist"
}

Webhook URL Setup For Imb Payment Gateway API.

Dear Partners, you need to add an endpoint for the Callback API. This endpoint will be used to update the status of the transaction through IMB Payment Gateway. We will assume that the update request has been accepted when you receive a successful response from the endpoint.

Note that only static URL structures are supported.

URL STRUCTURE: https://domain.in/path

Form-Encoded Payload (application/x-www-form-urlencoded)

We will send the following payload when we hit your API:

Response	SUCCESS, FAILD, TRUE, FALSE


{
	"status": "SUCCESS",
	"order_id": "TXN00743264723",
	"message": "Transaction Successfully",
	"result":
	{
		"txnStatus": "COMPLETED",
		"resultInfo": "Transaction Success",
		"orderId": "TXN00743264723",
		"amount": 100,
		"date": "2021-01-01 12:00:00",
		"utr": 435644746487,
		"customer_mobile": 9876543210,
		"remark1": "[email protected]",
		"remark2": "Your Data"
	}
}

Check Status API

This is the transaction check status API of Imb Payment Gateway, through this you can check your transaction very easily

URL: https://pay.imb.org.in/api/check-order-status

Form-Encoded Payload (application/x-www-form-urlencoded)

Request Parameters:

user_token	your Imb Payment Gateway Api Token
order_id	your reference id of transaction

Request:

{
    "user_token": "2048f66bef68633fa3262d7a398ab577",
    "order_id": "9876543210"
}

Success Response

{
    "status": "COMPLETED",
    "message": "Transaction Successfully",
    "result": {
        "txnStatus": "COMPLETED",
        "resultInfo": "Transaction Success",
        "orderId": "871868513",
        "status": "SUCCESS",
        "amount": 1,
        "date": "2024-08-24 20:06:20",
        "utr": "423776207603",
        "customer_mobile": "1234567890",
        "remark1": "test1",
        "remark2": "test2"
    }
}

Failed Response

{
    "status": ERROR,
    "message": "Error Massege",
    
}

Introduction

Welcome to the comprehensive documentation of the IMB Mobile and DTH Recharge API. This documentation serves as your go-to resource for understanding and implementing our powerful API, enabling you to seamlessly integrate mobile and DTH recharge services into your applications or platforms.
Our API documentation is designed to provide you with a clear and structured guide, ensuring a smooth integration process from start to finish. Whether you are a seasoned developer or new to API integrations, we have you covered with detailed explanations, code examples, and best practices.

Key Features of our Documentation:

Quick Start Guide:

Get up and running quickly with our step-by-step guide. It walks you through the initial setup, authentication process, and basic API usage, allowing you to start integrating our services without delay.

API Reference:

Gain a comprehensive understanding of the available endpoints, request parameters, and response formats. Our API reference provides detailed explanations for each API method, making it easy to navigate and utilize the full range of functionality.

Code Examples:

Accelerate your integration process with our extensive collection of code examples. These examples cover common use cases and demonstrate how to interact with the API using popular programming languages. You can easily adapt and integrate them into your own applications.

Error Handling:

Learn how to handle various error scenarios and gracefully respond to exceptions. Our documentation provides detailed explanations of error codes and messages, helping you troubleshoot and resolve issues efficiently.

Best Practices:

Discover industry best practices for optimizing performance, ensuring security, and maximizing the reliability of your API integrations. We provide guidelines and recommendations to help you achieve optimal results and deliver a seamless experience to your users.

Support and Community:

We are committed to your success. Should you encounter any challenges or have specific questions, our dedicated support team is available to assist you. Additionally, our vibrant developer community provides a platform for sharing insights, exchanging ideas, and collaborating with fellow developers.
By utilizing our comprehensive documentation, you can leverage the full potential of the IMB Mobile and DTH Recharge API. Whether you are building a mobile app, a web-based platform, or an enterprise solution, our documentation equips you with the knowledge and resources necessary to deliver a robust and user-friendly recharge experience.
We value your feedback and continuously strive to enhance our documentation to meet your needs. If you have suggestions, comments, or feature requests, please reach out to our team. We are committed to providing you with the best possible experience.
Start exploring our IMB Mobile and DTH Recharge API documentation today and unlock the power of seamless recharge services within your applications. Let us empower you to provide your users with a convenient and reliable recharge solution that enhances their experience and drives your business forward.

Header Token Security:


	CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIEJyaE02Q0UxdHhMRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l5'
  )

Features of the IMB Recharge API:

Easy integration into existing applications
Support for mobile and DTH recharge services
Secure authentication and data encryption
Comprehensive API documentation
Flexible and scalable architecture
Real-time status updates and notifications
Wide range of supported mobile operators and DTH providers
Customizable recharge plans and packages
Multiple payment options and gateway integrations
Robust error handling and exception management
High availability and reliable performance
Developer-friendly environment and support
Seamless user experience with intuitive interfaces
Detailed transaction logs and reporting
Compliance with industry standards and regulations
Constant updates and feature enhancements

Recharge Transaction API

this is the transaction api of recharge send the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/API/v1/Services/Recharge/doTxn

Method: POST

Operator List : name(id)

Airtel (11)
BSNL (13)
Idea (4)
JIO (18)
MTNL Delhi (33)
Vodafone (22)
Airtel Digital TV (12)
Dish TV (14)
Sun Direct (27)
TataSky (8)
Videocon D2H (10)

Request Parameters:

Operator	Operator id
Mobile	Mobile Number
Amount	Amount Ex.10
refId	Your Unique Transaction id

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/API/v1/Services/Recharge/doTxn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "Operator":18,  
  "Mobile":6234678278,    
  "Amount":199,     
  "refId":TXN082938219
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

{
  "response_code": 111,
  "message": "Recharge for Jio of Amount 15 is successful.",
  "status": "success",
  "RequestId": "IMB164640_649c1698931f2_20230628",
  "data": {
    "status": true,
    "response_code": 1,
    "operatorid": "18",
    "ackno": 688956123,
    "refid": "INRAXPY202306282525",
    "message": "Recharge for Jio of Amount 15 is successful."
  }
}

HLR Check API

this is the hlr check api of recharge transaction the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/API/v1/Services/Recharge/hlrcheck

Method: POST

Request Parameters:

number	Mobiile Number 10 Digit.
type	Mobile

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/API/v1/Services/Recharge/hlrcheck',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
                "number": 908XXXXXXXX98,
                 "type": Mobile
        
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

{
  "status": true,
  "response_code": 1,
  "info": {
    "operator": "Airtel",
    "circle": "Delhi NCR"
  },
  "message": "Fetch Successful"
}

Check Plan API

this is the check plan api of payout transaction the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/API/v1/Services/Recharge/CheckPlan

Method: POST

Request Parameters:

circle	Delhi NCR,Bihar Jharkhand etc.
op	operator id

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/API/v1/Services/Recharge/CheckPlan',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "circle": "Delhi NCR",
    "op": 18
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

							    
							        {
  "status": true,
  "response_code": 1,
  "info": {
    "FULLTT": null,
    "TOPUP": [
      {
        "rs": "10",
        "desc": "Talktime of Rs. 7.47, Talktime validity Unrestricted, No Service Validity available with this Talktime Pack",
        "validity": "N/A",
        "last_update": "08-04-2021"
      },
      {
        "rs": "20",
        "desc": "Talktime of Rs. 14.95, Talktime validity Unrestricted, No Service Validity available with this Talktime Pack",
        "validity": "N/A",
        "last_update": "08-04-2021"
      },
      {
        "rs": "30",
        "desc": "Talktime of Rs. 22.42, Talktime validity Unrestricted, No Service Validity available with this Talktime Pack",
        "validity": "N/A",
        "last_update": "08-04-2021"
      },
      {
        "rs": "500",
        "desc": "Talktime of Rs. 423.73,Talktime validity Unrestricted",
        "validity": "N/A",
        "last_update": "08-04-2021"
      },
      {
        "rs": "1000",
        "desc": "Talktime of Rs. 847.46,Talktime validity Unrestricted",
        "validity": "N/A",
        "last_update": "08-04-2021"
      },
      {
        "rs": "5000",
        "desc": "Talktime of Rs. 4237.29,Talktime validity Unrestricted",
        "validity": "N/A",
        "last_update": "08-04-2021"
      }
    ],
    "3G/4G": [
      {
        "rs": "251",
        "desc": "50GB Data Pack validity for 28 days.",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "351",
        "desc": "100GB Data Pack validity for 56 days",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "355",
        "desc": "Now get 1 year ZEE5 Premium access. Also get 50GB Data valid for 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      }
    ],
    "2G": [
      {
        "rs": "251",
        "desc": "50GB Data Pack validity for 28 days.",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "351",
        "desc": "100GB Data Pack validity for 56 days",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "355",
        "desc": "Now get 1 year ZEE5 Premium access. Also get 50GB Data valid for 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      }
    ],
    "SMS": [
      {
        "rs": "12",
        "desc": "Get 120 local/national SMS for 10 days, No service validity ",
        "validity": "10 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "26",
        "desc": "Get 250 local/national SMS for 28 days, No service validity",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "32",
        "desc": "Get access to Over 200 Popular Ad-free Games for 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "36",
        "desc": "Get 350 local/national SMS for 28 days, No service validity",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "42",
        "desc": "Get Unlimited SMS score alerts for on-going Cricket match and Chance to talk to Sports celebrity (Min 5 event in a month).  Pack validity 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "43",
        "desc": "Recharge with Contest Pack and get a chance to win Recharges, Gold Voucher & more every week. Validity 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "52",
        "desc": "Now Enjoy Live Chat with Bollywood celebrity, (Min 5 event in a month), Pack validity 28 Days",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "62",
        "desc": "Get access to Over 200 Popular Ad-free Games for 89 Days",
        "validity": "89 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "72",
        "desc": "Get Unlimited SMS score alerts for on-going Cricket match and Chance to talk to Sports celebrity (Min 5 event in a month).  Pack validity 89 Days",
        "validity": "89 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "73",
        "desc": "Recharge with Contest Pack and get a chance to win Recharges, Gold Voucher & more every week. Validity 89 Days",
        "validity": "89 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "99",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 1GB Data + 100 Local and National SMS. Pack Validity for 18 Days ",
        "validity": "18 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "103",
        "desc": "Now Enjoy Live Chat with Bollywood celebrity, (Min 5 event in a month), Pack validity 89 Days",
        "validity": "89 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "129",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 2GB + 300SMS.Pack Validity for 24 Days",
        "validity": "24 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "148",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 1GB/Day + 100SMS/Day for 18 days",
        "validity": "18 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "149",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 2GB Data + 300 Local and National SMS. Pack Valid for 28 Days - Vi Movies & TV access",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "199",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 1GB/Day + 100SMS/Day.Pack Validity for 24 Days - Vi Movies & TV access",
        "validity": "24 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "218",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks to all Networks +6GB Data+100 Local and National SMS/Day for 28 Days - Vi Movies & TV access",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "219",
        "desc": "Now get 1GB/Day Data + Truly Unlimited FREE Local/STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Valid for 28 Days - Vi Movies & TV access",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "248",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 8GB Data + 100SMS/Day. Validity 28 Days - Vi Movies & TV access",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "249",
        "desc": "1.5 GB/Day Data + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Valid for 28 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "269",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 4GB+ 600SMS.Pack Validity for 56 Days - Vi Movies & TV access",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "301",
        "desc": "Now get 1.5GB/Day+Truly Unlimited FREE Local/STD/Roaming Calls+100 Local/National SMS/Day. Validity-28Days Rs1000/Day Hospicare cover by Aditya Birla Health Insurance. 10Days at a time, upto 30Days/yr. For 18-55yrs with sound health in non-hazardous jobs.Insurance as per name in VIL recordsTnC Binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost Vi Movies and TV access also.",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "379",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 6GB Data + 1000 Local and National SMS. Pack Validity for 84 Days - Vi Movies & TV access",
        "validity": "84 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "398",
        "desc": "3GB/Day+ Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100 SMS/Day for 28 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "399",
        "desc": "1.5 GB/Day +Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Valid for 56 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "405",
        "desc": "Now get 1 year ZEE5 Premium access + 90GB Data + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100SMS/day, valid for 28 DaysNow binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "449",
        "desc": "Now get DOUBLE Data, i.e. 2+2=4GB/Day + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Valid for 56 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "499",
        "desc": "Now get Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks +1.5GB Data daily + 100 SMS daily. Pack Valid for 70 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over.At NO extra cost! Vi Movies and TV access also. ",
        "validity": "70 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "555",
        "desc": "Now get Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 1.5GB/Day + 100 Local and National SMS/Day. Pack Validity for 77 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "77 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "558",
        "desc": "Now get Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 3GB/Day Data + 100 Local and National SMS/ Day. Pack Validity for 56 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "595",
        "desc": "Now get 1 year ZEE5 Premium access. Also get 2GB/Day Data + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100SMS/day, valid for 56 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "599",
        "desc": "1.5 GB/Day +Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Valid for 84 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "84 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "601",
        "desc": "Binge Nonstop all year-LIVE T20 action, Hotstar Specials, Multiplex Movies with 1yr Disney+ Hotstar VIP subscription + 3GB/Day + 32GB EXTRA + Truly Unlimited Calls + 100 SMS/D for 56 days.Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Access Vi Movies and TV also ",
        "validity": "56 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "795",
        "desc": "Now get 1 year ZEE5 Premium access. Also get 2GB/Day Data + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100SMS/day, valid for 84 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also. ",
        "validity": "84 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "801",
        "desc": "Binge Nonstop all year-LIVE T20 action, Hotstar Specials, Multiplex Movies with 1yr Disney+ Hotstar VIP subscription + 3GB/Day + 48 GB EXTRA + Truly Unlimited Calls + 100 SMS/D for 84 days.Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Access Vi Movies and TV also ",
        "validity": "84 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "819",
        "desc": "2GB/Day Data + Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 100SMS/Day for 84 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over.At NO extra cost! Vi Movies and TV access also. ",
        "validity": "84 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "1197",
        "desc": "Get 1 year ZEE5 Premium access + 1.5GB/Day + Truly Unlimited FREE Local/STD/Roaming Calls to all Networks + 100 Local and National SMS/Day. Pack Validity for 180 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Access Vi Movies and TV also. ",
        "validity": "180 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "1499",
        "desc": "Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 24GB Data + 3600 Local and National SMS. Pack Validity for 365 Days - Vi Movies & TV access",
        "validity": "365 days",
        "last_update": "08-04-2021"
      }
    ],
    "COMBO": [
      {
        "rs": "2399",
        "desc": "Now get Truly Unlimited FREE Local/ STD/Roaming Calls to all Networks + 1.5GB/Day + 100 Local and National SMS/Day. Pack Validity for 365 Days. Now binge all night, with NO limits. Surf, Stream, Share all you want from 12midnight to 6am without pack deduction. ALSO enjoy nonstop weekends with all Unused Data from Mon-Fri, with Weekend roll-over. At NO extra cost! Vi Movies and TV access also.",
        "validity": "365 days",
        "last_update": "08-04-2021"
      }
    ],
    "Romaing": [
      {
        "rs": "295",
        "desc": "40 mins of international roaming calls which include Outgoing local calls, calls back to India and Incoming Calls only. Applicable in USA, UAE, Singapore, Thailand, UK, Sri Lanka, China, Saudi Arabia, Qatar, Oman, Bahrain, Kuwait, Nepal, Bangladesh, Indonesia, Malaysia, Australia, NZ, Canada & many more! Validity: 28 days. T&C Apply",
        "validity": "28 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "695",
        "desc": "In 23 countries including the US, UAE, Singapore, Thailand, Malaysia, UK, New Zealand & more destinations enjoy FREE data up to 1GB (Rs.1/MB after 1GB) FREE SMS & FREE incoming calls. Plus 120mins FREE outgoing calls(local & to India), after 120 mins Re.1/min. In 45 other countries, Enjoy 300MB data (Re.1/MB after 300MB) & 10 Free SMS (Re.1/SMS after 10SMS). Also enjoy FREE incoming calls with 50mins FREE outgoing calls(local & to India), after 50 mins Re.1/min. Standard roaming rates apply for Outgoing calls to other countries",
        "validity": "1 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "995",
        "desc": "Get FREE 150 min outgoing & incoming calls & 500 MB when roaming abroad in US, UK, Singapore, Thailand, Malaysia, Bangladesh, Sri Lanka, China, Kenya, Germany, Belgium, Turkey, Netherlands & more! Also, get FREE 100 min & 100 MB when roaming in UAE, Saudi Arabia, Qatar, Oman, Kuwait, Bahrain, Afghanistan, Nepal, Indonesia, Russia, Egypt. Validity: 7 days. T&C Apply",
        "validity": "7 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "1495",
        "desc": "Get FREE 300 min outgoing & incoming calls & 1GB when roaming abroad in US, UK, Singapore, Thailand, Malaysia, Europe (Germany, Belgium, France, Netherlands, Italy, Spain, Greece), Australia, NZ, Bangladesh, China, Turkey & more! Also, get FREE 150 min & 250 MB when roaming in UAE, Saudi Arabia, Qatar, Oman, Kuwait, Bahrain, Afghanistan, Nepal, Indonesia, Russia, Egypt. Validity: 14 days. T&C Apply",
        "validity": "14 days",
        "last_update": "08-04-2021"
      },
      {
        "rs": "2695",
        "desc": "In 23 countries including the US, UAE, Singapore, Thailand, Malaysia, UK, New Zealand & more destinations enjoy FREE data up to 4GB (Rs.1/MB after 4GB) FREE SMS & FREE incoming calls. Plus 120mins/day FREE outgoing calls(local & to India), after 120 mins Re.1/min. In 45 other countries, enjoy 1.2GB data (Re.1/MB after 1.2GB) & 40 Free SMS (Re.1/SMS after 40SMS). Also enjoy FREE incoming calls with 200mins FREE outgoing calls(local & to India), after 200 mins Re.1/min. Standard roaming rates apply for Outgoing calls to other countries",
        "validity": "4 days",
        "last_update": "08-04-2021"
      }
    ]
  },
  "message": "Fetch Successful"
}

Check Status API

this is the check status api of recharge transaction the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/API/v1/Services/Recharge/CheckStatus

Method: POST

Request Parameters:

referenceid	your reference id of transaction

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/API/v1/Services/Recharge/CheckStatus',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "referenceid" : "TXN6PYT22395476"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

{
  "responsecode": 1,
  "status": true,
  "data": {
    "txnid": "79394",
    "operatorname": "Airtel",
    "canumber": "9971355854",
    "amount": "10",
    "comm": "0.02",
    "tds": "0.00",
    "status": "1",
    "refid": "6734567895",
    "operatorid": "DUMMYOPERATOR ID",
    "dateadded": "2023-06-13 13:30:22",
    "refunded": "0",
    "refundtxnid": "",
    "daterefunded": null
  },
  "message": "Transaction Enquiry Successful"
}

Introduction

Introduction to BBPS API by IMB Payments

Bharat Bill Payment System (BBPS) by IMB Payments is a unified platform that offers integrated and interoperable bill payment services to customers, agents, and businesses across India.

Our BBPS API provides seamless access to all available features, allowing you to integrate with a wide variety of billers for electricity, water, gas, DTH, telecom, and more.

The API is designed for fast and secure transactions, ensuring that your users experience smooth and reliable bill payment processes.

In this documentation, we will guide you through the various API endpoints, request and response formats, and usage examples, helping you to integrate the BBPS services into your application with ease.

Header Token Security:


	CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIEJyaE02Q0UxdHhMRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l5'
  )

Features of the IMB BBPS API:

Easy integration into existing applications
Support for mobile and DTH recharge services
Secure authentication and data encryption
Comprehensive API documentation
Flexible and scalable architecture
Real-time status updates and notifications
Wide range of supported mobile operators and DTH providers
Customizable recharge plans and packages
Multiple payment options and gateway integrations
Robust error handling and exception management
High availability and reliable performance
Developer-friendly environment and support
Seamless user experience with intuitive interfaces
Detailed transaction logs and reporting
Compliance with industry standards and regulations
Constant updates and feature enhancements

Operators List API

this is the transaction api of bbps operators list send the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/api/v1/bill-payment/operatorslist

Method: POST

Request Parameters:

operators_type	Operator Type ex: bbps

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/bill-payment/operatorslist',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "operators_type" : "BBPS" 
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

							    
							        {
    "response_code": 111,
    "status": true,
    "message": "Operators Fetched Successfully.",
    "operators_list": [
        {
            "id": "989",
            "name": "121 Finance Private Limited",
            "category": "EMI",
            "viewbill": "1",
            "regex": "^[A-Za-z0-9\\@\\s\\-]{8,35}$",
            "displayname": "Loan Account Number",
            "ad1_d_name": null,
            "ad1_name": null,
            "ad1_regex": null,
            "ad2_d_name": null,
            "ad2_name": null,
            "ad2_regex": null,
            "ad3_d_name": null,
            "ad3_name": null,
            "ad3_regex": null
        },
        {
            "id": "415",
            "name": "Aadhar Housing Finance Limited",
            "category": "EMI",
            "viewbill": "1",
            "regex": "^[a-zA-Z0-9]+$",
            "displayname": "Application ID",
            "ad1_d_name": null,
            "ad1_name": null,
            "ad1_regex": null,
            "ad2_d_name": null,
            "ad2_name": null,
            "ad2_regex": null,
            "ad3_d_name": null,
            "ad3_name": null,
            "ad3_regex": null
        },
        {
            "id": "122",
            "name": "Aavantika Gas Ltd",
            "category": "Gas",
            "viewbill": "1",
            "regex": "^[0-9a-zA-Z]{10,15}$",
            "displayname": "Customer No",
            "ad1_d_name": null,
            "ad1_name": null,
            "ad1_regex": null,
            "ad2_d_name": null,
            "ad2_name": null,
            "ad2_regex": null,
            "ad3_d_name": null,
            "ad3_name": null,
            "ad3_regex": null
         },
        ]
    }

Bill Fetch API

this is the bill fetch api of bbps api the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/api/v1/bill-payment/fetchbill

Method: POST

Request Parameters:

operator	Operator id .
canumber	Consumer Number
mode	Online
ad1	Addistion Parameter
ad2	Addistion Parameter

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/bill-payment/fetchbill',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "operator":286,
    "canumber":7745309263,
    "mode":"online"
     //"ad1":"pass value according to operator"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

							    
							        {
    "response_code": 111,
    "status": true,
    "message": "Bill Fetched Successfully.",
    "customer_name": "Sourabh Jha",
    "bill_amount": "900.5",
    "bill_duedate": null,
    "bill_data": {
        "billAmount": "900.5",
        "billnetamount": "900.5",
        "acceptPayment": true,
        "acceptPartPay": false,
        "cellNumber": "7745309263",
        "userName": "Sourabh Jha"
    }
}

Bill Pay API

this is the Bill Payment api of BBPS the required data in json to our url and pass the token in header.

URL: https://secure.imbpayment.com/api/v1/bill-payment/billpay

Method: POST

Request Parameters:

operator_id	Operator id .
canumber	Consumer Number
bill_amount	Amount
reference_id	Unique Reference Id
latitude	2568.955685
longitude	5665.68685
mode	Online
bill_data	Bill Data ( in bill fetch response)

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/bill-payment/billpay',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
            "operator_id" : 286,
            "canumber" : 7745309263,
            "bill_amount" : 900.5,
            "reference_id" : "TXNID00048354",
            "latitude" : "24.792480",
            "longitude" : "85.007713",
            "mode" : "online",
            "bill_data" : {
        "billAmount": "900.5",
        "billnetamount": "900.5",
        "acceptPayment": true,
        "acceptPartPay": false,
        "cellNumber": "7745309263",
        "userName": "Sourabh Jha"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail

							    
							        
							       {
    "message": "Pending Transaction is on hold.",
    "response_code": 112,
    "status": true,
    "bill_status": "Pending",
    "billdetails": {
        "operator_id": 266,
        "operator_name": null,
        "ack_no": 113288717,
        "opening_balance": "929.00",
        "closing_balance": "29.50"
        
                }
            }

Generate OTP For Aadhaar API

This API allows you to generate an OTP for a given Aadhaar number. The OTP is sent to the mobile number that is linked to the provided Aadhaar number, which can then be used for Aadhaar offline verification. The API is particularly useful in systems that require identity verification using Aadhaar, providing an extra layer of security through OTP-based validation.

URL: https://secure.imbpayment.com/api/v1/verification/aadhaar/sendotp

Method: POST

Request Parameters:

aadhaar_number	12 Digit Aadhaar Number
ref_id	your reference id of aadhaar verification

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/verification/aadhaar/sendotp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "aadhaar_number" : "556175339076",
    "ref_id" : "VFR000001111"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail


{
    "response_code": 111,
    "message": "OTP sent successfully",
    "RequestId": "VFR000001111"
}

Verify OTP For Aadhaar API

This API allows you to generate an OTP for a given Aadhaar number. The OTP is sent to the mobile number that is linked to the provided Aadhaar number, which can then be used for Aadhaar offline verification. The API is particularly useful in systems that require identity verification using Aadhaar, providing an extra layer of security through OTP-based validation.

URL: https://secure.imbpayment.com/api/v1/verification/aadhaar/verify

Method: POST

Request Parameters:

otp	6 Digit OTP Send to Aadhaar Linkend Mobile Number
ref_id	your reference id of aadhaar verification

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/verification/aadhaar/verify',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "otp" : "999999",
    "ref_id" : "VFR000001111"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail


{
    "response_code": 111,
    "message": "Aadhaar Verified Successfully",
    "RequestId": "VFR0000014",
    "data": {
        "ref_id": "245646390",
        "status": "VALID",
        "message": "Aadhaar Card Exists",
        "care_of": "S/O: Sanjay Shukla",
        "address": "new town, Raja Bazar, Raipur, howrah, Raipur, Kolkata, India, 700282",
        "dob": "27-09-1997",
        "email": "",
        "gender": "M",
        "name": "Rajesh Shukla",
        "split_address": {
            "country": "India",
            "dist": "howrah",
            "house": "new town",
            "landmark": "",
            "pincode": "700282",
            "po": "Raja Bazar",
            "state": "Kolkata",
            "street": "",
            "subdist": "Raipur",
            "vtc": "Raipur"
        },
        "year_of_birth": "1997",
        "mobile_hash": "4889b89338473wfyyry4430b47b5cbe9fireit88td8313e",
        "photo_link": "",
        "share_code": "5445",
        "xml_file": ""
    }
}

Verify Pan API

Use this API to check if a specific PAN is valid. Upon verification, the response will include the name associated with the PAN and the type of PAN (either Individual or Business) for valid entries. Please refer to the provided test data for triggering validations.

URL: https://secure.imbpayment.com/api/v1/verification/pan

Method: POST

Request Parameters:

pan_no	10 Digit Pancard Number
name Optional	Provide Name on Pancard Number
ref_id	your reference id of pan verification

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/verification/pan',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "pan_no" : "WRBPI2561R",
    "ref_id" : "VFR00000124632",
    "name" : "John Doe"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail


{
    "response_code": 111,
    "message": "PAN verified successfully",
    "RequestId": "VFR00000124632",
    "data": {
        "pan": "WRBPI2561R",
        "type": "Individual",
        "reference_id": "VFR00000124632",
        "name_provided": "john doe",
        "registered_name": "JOHN DOE",
        "father_name": "",
        "valid": true,
        "message": "PAN verified successfully",
        "verification_id": 6429456855
    }
}

Verify Bank API

Utilize this API to perform real-time bank account verification. The response will confirm the validity of the account. Refer to the provided test data to initiate the required validations.

URL: https://secure.imbpayment.com/api/v1/verification/bank

Method: POST

Request Parameters:

account_no	Your Bank Account Number
ifsc	Your Bank IFSC Code
name Optional	Your Bank Account Holder Name
ref_id	your reference id of bank verification

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/verification/bank',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "account_no" : "5653878278",
    "ifsc" : "SBIN00849432",
    "ref_id" : "VFR0004432423"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail


{
    "response_code": 111,
    "message": "Bank Account details verified successfully",
    "RequestId": "VFR0004432423",
    "data": {
        "verification_id": "355054754345",
        "reference_id": "VFR0004432423",
        "accountStatus": "VALID",
        "name_at_bank": "Mr. JHON DOE",
        "bank_name": "STATE BANK OF INDIA",
        "utr": null,
        "city": "KOLKATA",
        "branch": "HOWRAH,KOLKATA",
        "nameMatchScore": null,
        "nameMatchResult": null
    }
}

Verify UPI API

Utilize this API to validate the UPI VPA details of your customers. This version improves efficiency by removing unnecessary fields from the response, providing a more streamlined output.

URL: https://secure.imbpayment.com/api/v1/verification/upi

Method: POST

Request Parameters:

upi_id	your upi id
name Optional	Your Bank Account Holder Name
ref_id	your reference id of upi verification

CURL Request:


							    

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://secure.imbpayment.com/api/v1/verification/upi',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "upi_id" : "test@vpa",
    "ref_id" : "VFR0054351",
    "name" : "John Doe"
}',
  CURLOPT_HTTPHEADER => array(
    'Token: WVpJYWFCNFlpM3ZzSTg1R3VZUmN3UzNGY01ISk1heHNCcm5tRUMyQmF5WmlIUkNrTEJRkR0bHZoNlROYm9NTHcvRFYvMXlVVnJJWFAvemVmQ2ZweFp4Sitrc3l',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response Json:

Response Code	111,112= Success, 113= Fail


{
    "response_code": 111,
    "message": "UPI Verified Successfully",
    "RequestId": "VFR0054351",
    "data": {
        "verification_id": 236757076641,
        "reference_id": "VFR0054351",
        "status": "VALID",
        "name_at_bank": "JOHN DOE",
        "upi_id": "test@upi"
    }
}