Hitpixel Netvalve Payment gateway HPP API Integration

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", (Customer Phone in the format of coutrycode-phone . e.g +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.

Netvalve Documentation

API error codes

Please refer to the document below for a list of API response codes and descriptions.

Netvalve Error Codes