Enabling Kount verification with the API

Background
Before starting this tutorial, make sure you understand the following topics from the Quick start section:

You can enable Kount verification while saving a card token or running a transaction
with the iframe, with your own form, or through the API.

Nexio will run one of two Risk Inquiry Service (RIS) requests depending on whether customer information (customer.customerRef) is provided in the request body:

Information ProvidedInquiry Mode
Customer Ref ProvidedKount Central full inquiry with returned thresholds (Inquiry Mode: W)
Customer Ref Not ProvidedDefault Inquiry (Inquiry Mode: Q)

(Please see Kount's documentation for more information on Inquiry Modes.)

While saving a card token

  1. Configure Your Account

    Contact Integrations Support to ensure Kount is enabled on your merchant account.

  2. Request a One-time-use Token

    Request an e-commerce one-time-use token.

    curl -X POST https://api.nexiopaysandbox.com/pay/v3/token \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -H 'Authorization: Basic [Base64_encoded_login]'
      -d '{}'
    

  3. Post Card Information to Nexio

    Send a POST request to the Save card token endpoint.
    Include the token from step 2, the card information and the object "processingOptions": { "checkFraud": true } in the body of your request.

    curl -X POST https://api.nexiopaysandbox.com/pay/v3/process \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -H 'Authorization: Basic [Base64_encoded_login]'
      -d '{
      "data": {},
      "tokenex": {
        "token": "6ee140a0-05d1-4958-8325-b38a690dbb9d"
      },
      "processingOptions": {
        "checkFraud": true
      }
    }'
    

While running a transaction

  1. Configure Your Account

    Contact Integrations Support to ensure Kount is enabled on your merchant account.

  2. Post Card Information to Nexio

    Post payment and the previously saved card token to the Run card transaction endpoint.

    Include the object "processingOptions": { "checkFraud": true } in the body of your request.

    curl -X POST https://api.nexiopaysandbox.com/pay/v3/process \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -H 'Authorization: Basic [Base64_encoded_login]'
      -d '{
      "data": {},
      "tokenex": {
        "token": "6ee140a0-05d1-4958-8325-b38a690dbb9d"
      },
      "processingOptions": {
        "checkFraud": true
      }
    }'