NetBanking
RP Integration option
This integration option supports the following operations:
Payment
Request
Send a payment request with the following data:
Parameter | Type | Description |
---|---|---|
method | object | A section of the payment method information. |
type * required |
string | net_banking |
customer | object | A section of the customer details. |
first_name * required |
string | The customer's first name. |
last_name * required |
string | The customer's last name. |
country * required |
string | The customer's country code. Set to IN . |
string | The customer's email address. | |
city * required |
string | The customer's city. |
state * required |
string | The customer's two-digit state code, for example MH . |
zip * required |
string | The customer's postal code. |
address * required |
string | The customer's address. |
phone * required |
string | The customer's phone number. |
Response
The net_banking
response section will have the parameters copied from the request and additionally the form
parameter to build a form where you should redirect the customer to finalize the payment.
Payout
Request
Send a payout request with the following data:
Parameter | Type | Description |
---|---|---|
method | object | A section of the payment method information. |
type * required |
string | net_banking |
account * required |
string | The customer's account number. |
account_name * required |
string | The customer's account name. |
bank_name * required |
string | The customer's bank name. |
bank_code * required |
string | The customer's bank IFSC code. |
bank_branch_code * required |
string | The customer's bank branch name. |
region_account * required |
string | The customer's bank address. |
customer | object | A section of the customer details. |
country * required |
string | The customer's country code, for example IN . |
id_number * required |
string | The customer's username. |
Response
The net_banking
response section will have the parameters copied from the request.
QP Integration option
This integration option supports the following operations:
Request for the supported banks
Request
To get the list of the supported banks, send aGET
request to https://api.constantpos.com/beyag/gateways/{gateway_id}/bank_list
, where gateway_id
stands for the ID of the payment gateway activated for your shop for the NetBanking payments. To get the gateway ID, contact Tech Support Team or your account manager.
Response
The system returns the response with the data
property. It contains the payment methods that are active for the requested payment gateway. Each payment method property shows the parameters and the possible values that are required to process transactions via these payment methods.
Check the data.net_banking.method.channel
parameter array for the IDs and names of the supported bank. Use the id
of the required bank in the payment request.
Payment
Request
Send a payment request with the following data:
Parameter | Type | Description |
---|---|---|
method | object | A section of the payment method information. |
type * required |
string | net_banking |
channel * required |
string | The id of the required bank as received in the response to the bank list request described above. |
customer | object | A section of the customer details. |
first_name * required |
string | The customer's first name. |
last_name * required |
string | The customer's last name. |
email * required |
string | The customer's email address. |
Response
The net_banking
response section will have parameters copied from the request. Additionally, you'll get the form
parameter to build a form where the customer should be redirected to finalize the payment.
II Integration option
Payment flow
- Customer initiates the payment on the merchant's website and selects NetBanking as a payment method.
- Merchant sends the payment request to Constantpos.
- Constantpos returns a link to the payment page to the merchant.
- The merchant redirects the customer to the payment page.
- The customer completes the payment.
- Constantpos sends a webhook notification to the merchant.
Payment
Request
Send a payment request with the following additional parameters:
Parameter | Type | Description |
---|---|---|
request | object | |
return_url * required |
string | URL to return the customer to when the transaction is completed. |
method | object | A section of the payment method. |
type * required |
string | net_banking |
customer * required |
object | A section of information about the customer. |
first_name * required |
string | The customer's first name. |
last_name * required |
string | The customer's last name. |
phone * required |
string (10) | The customer's phone number. |
email * required |
string (100) | The customer's email address. |
country | string (3) | The customer's country in the ISO 3166-1 Alpha-2 format. |
city | string(60) | The customer's city. |
zip | string | The customer's billing ZIP or postal code. |
address | string(255) | The customer's address. |
Request example
{
"request": {
"amount": 20000,
"currency": "INR",
"description": "description",
"test": false,
"return_url": "https://someurl.com",
"customer": {
"first_name": "John",
"last_name": "Doe",
"country": "IN",
"phone": "1770000077",
"email": "user@example.com"
},
"method": {
"type": "net_banking"
}
}
}
Response
The net_banking
response section will have parameters copied from a request. Additionally, you'll get the form
parameter to build a form where the customer should be redirected to finalize the payment.
Response example
{
"transaction": {
"uid": "9c27d028-7b0e-4ced-9a32-d65a623c07a7",
"type": "payment",
"status": "pending",
"amount": 20000,
"currency": "INR",
"description": "description",
"created_at": "2023-12-22T11:26:59Z",
"updated_at": "2023-12-22T11:27:00Z",
"method_type": "upi",
"receipt_url": "https://my.constantpos.com/customer/transactions/9c27d028-7b0e-4ced-9a32-d65a623c07a7/9567f4ebd9d2d7ca21b07642c236ae7d3eb892fb2c75d972ce431857771e44d8",
"payment": {
"status": "pending",
"gateway_id": 3559,
"message": "Transaction was initialized."
},
"net_banking": {
"type": "net_banking"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "user@example.com",
"country": "IN",
"phone": "17700000777777",
"ip": null
},
"manually_corrected_at": null,
"message": "Transaction was initialized.",
"test": false,
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"email": "user@example.com",
"country": "IN",
"phone": "17700000777777"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "payment-url/9c27d028-7b0e-4ced-9a32-d65a623c07a7",
"method": "POST",
"fields": []
}
}
}