Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

Smart Routing is a feature of the Netvale payment gateway that directs transactions to specific payment processors/mids based on defined rules.

Clients/Accounts can be associated with multiple sites, each of which can have multiple routing rules based on Currency, Country, Card Type, and BIN. Each routing rule includes configurations for Primary Mid, Retry Mid, and Amount Limits.

Please reach out to the Netvalve Admin to enable Smart Routing configurations. For further information, please refer to the page below.

Configure Smart Routing

Integration steps

We require the addition of a new parameter (siteId) in the following APIs.

e.g. "siteId": "0b81bdb1-d33b-48aa-8c48-a38f5cffd558"

Contact Netvalve Admin/Support to get siteId and add that in your configuration same as midId and netvalveMidId

Note:- To process transactions using smart routing, you need to send the siteId parameter. Do not include the parameters midId or netvalveMidId in the API request. If either midId or netvalveMidId is included in the request, the transaction will be processed using the provided midId or netvalveMidId, and smart routing will not be utilized.

  • Sale / Authorization API:- added siteId instead of midId / netvalveMidId

    POST {{paymentApiUrl}}/sale 
AND
POST {{paymentApiUrl}}/authorize
Request json :- 
{
    "amount": 100.00,
    "cardExpireMonth": "XX",
    "cardExpireYear": "XXXX",
    "cardHolderName": {{cardHolderName}},
    "cardSecurityCode": "XXX",
    "cardNumber": {{cardNumber}},
    "clientOrderId": {{clientOrderId}},
    "currency": {{currency}},
    "customerAddress": {{customerAddress}},
    "customerCity": {{customerCity}},
    "customerCountryCode": {{customerCountryCode}},
    "customerEmail": {{customerEmail}},
    "customerIp": "123.123.123.123",
    "customerName": {{customerEmail}},
    "customerFirstName": {{customerFirstName}},
    "customerLastName": {{customerLastName}},
    "customerPhone": {{customerPhone}},
    "customerState": {{customerState}},
    "customerZipCode": {{customerZipCode}},
    "siteId": "0b81bdb1-d33b-48aa-8c48-a38f5cffd558"
}

There is no change in response json

  • Hosted payment page to create order API:- added siteId instead of midId / netvalveMidId

    POST {{hppApiUrl}}/hpp/order
Request Json :- 
{
  "siteId": "0b81bdb1-d33b-48aa-8c48-a38f5cffd558",
  "amount": 0,
  "currency": "string",
  "netvalveMidId": "string",
  "clientOrderId": "string",
  "orderDesc": "string",
  "successUrl": "string",
  "cancelUrl": "string",
  "failedUrl": "string",
  "slimMode": true,
  "isBillingAndShippingDetailsSame": true,
  "customerDetails": {
    "customerIp": "string",
    "customerEmail": "string",
    "customerName": "string",
    "customerLastName": "string",
    "customerAddress": "string",
    "customerZipCode": "string",
    "customerCity": "string",
    "customerState": "string",
    "customerCountryCode": "st",
    "customerPhone": "string"
  },
  "billingDetails": {
    "billingAddress": "string",
    "billingZipCode": "string",
    "billingCity": "string",
    "billingState": "string",
    "billingCountryCode": "st"
  },
  "shippingDetails": {
    "shippingAddress": "string",
    "shippingZipCode": "string",
    "shippingCity": "string",
    "shippingState": "string",
    "shippingCountryCode": "st"
  },
  "additionalParameters": {
    "property1": "string",
    "property2": "string"
  }
}

There is no change in response json

  • 3DS Standalone API

    1. 3DS initialization:- added siteId instead of midId / netvalveMidId

      POST {{paymentApiUrl}}/3ds/initialization
request json :- 
{
  "siteId": "0b81bdb1-d33b-48aa-8c48-a38f5cffd558"
  "cardNumber": "string",
  "cardExpireMonth": "string",
  "cardExpireYear": "stri",
  "cardHolderName": "string",
  "amount": 0,
  "currency": "string",
  "merchantRedirectUrl": "string"
}
There is no change in response json

    2. 3DS authentication:- Removed midId / netvalveMidId 

      POST {{paymentApiUrl}}/3ds/authentication
request json :- 
{
  "transID": "string",
  "amount": 0,
  "currency": "string",
  "cardNumber": "string",
  "cardExpireMonth": "string",
  "cardExpireYear": "stri",
  "cardHolderName": "string",
  "challengeIndicator": "string",
  "browserInfo": "string",
  "customerIp": "string",
  "customerEmail": "string",
  "customerName": "string",
  "customerLastName": "string",
  "customerAddress": "string",
  "customerZipCode": "string",
  "customerCity": "string",
  "customerState": "string",
  "customerCountryCode": "st",
  "customerPhone": "string",
  "dfReferenceId": "string",
  "acsWindowSize": 0
}
There is no change in response json

    3. 3DS result:- Removed midId / netvalveMidId 

      POST {{paymentApiUrl}}/3ds/result
request json :- 
{
  "transID": "string"
}
There is no change in response json

Swagger API documentation is also updated in the Netvale documentation link below

https://docs.netvalve.com/

  • No labels