The following describes the integration steps for Netvalve Payment Gateway HPP API. Contact the Netvalve team to ensure the HPP API configuration steps have been followed, and you have credentials for the HPP API authentication.
Flow
Netvalve Payment Gateway HPP Flow
In the Netvalve gateway, we offer a Hosted Payment Page (HPP) to merchants. This HPP operates in two modes: slim_mode, which is designed to be used with an IFRAME, and the other mode is a full-page redirect.
HPP Transaction States:
Sequence Diagram:
Payment Page :
Integration
Create Order APIs
Create Order
API:- {{hppApiUrl}}/hpp/order
POST
Request JSON like
{
"amount": 44.00,
"currency": "USD",
"midId" : {{midId}},
"clientOrderId": {{clientOrderId}},
"orderDesc": "Test",
"successUrl": "https://website.com/succss.html",
"cancelUrl": "https://website.com/cancle.html",
"failedUrl": "https://website.com/failed.html",
"customerDetails": {
"customerAddress": "Test",
"customerCity": "Test",
"customerCountryCode": "IN",
"customerEmail": "test@test.com",
"customerIp": "123.123.123.123",
"customerName": "Test",
"customerLastName": "Test",
"customerPhone": "+919900000000,
"customerState": "MH",
"customerZipCode": "123456"
}
}
Note:- As a new 3DS Visa mandate, the customer needs to send an email and phone in the below format to avoid 3DS compliance issues.
"customerEmail": "yogesh@dahe.com",
"customerPhone": "+919900000000",
After the Hosted payment page call, For any reason, if you are not able to get a valid response or transaction status from the gateway like below
{
"traceID": "965c2c75-b29d-41fc-aa3a-6d40b9f3fbb0",
"responseTimestamp": "2024-04-25T13:48:49.959+00:00",
"transactionID": 22,
"responseCode": "GTW_1002",
"responseMessage": "Transaction status is Pending.",
"responseCodeType": "PENDING"
}
you can call inquiry API For Transaction result status.
For detailed information on the request and response structure for the aforementioned APIs, please refer to our Swagger API documentation linked below.
API error codes
Please refer to the document below for a list of API response codes and descriptions.