Enabling Kount verification with your own form

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. Prepare the Iframe

    Follow steps 1-6 of the Creating a save card page with the iframe tutorial.

  3. Request a One-time-use Token

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

    (This is step 7a of the Creating a save card page with the iframe tutorial.)

    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 '{}'
    
  4. Post Card Information to Nexio

    Follow step 7b of the Creating a save card page with the iframe tutorial. Include the object "processingOptions": { "checkFraud": true } in the body of your request.

    curl -X POST https://api.nexiopaysandbox.com/pay/v3/saveCard \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -H 'Authorization: Basic [Base64_encoded_login]'
      -d '{
      "card": {
        "cardHolderName": "John H Doe",
        "encryptedNumber": "cu3yRktaYFK2LUC6DpNK289tYDsGRCi7cO+GeG0hkeYFvT7Y8/oY5r53obMz6Q/BZ38gk2u2Ufwy8ojBcX2sfNjG5jplGTXA4NNlSIUjMFfiHe1sff1JFpThoiW/IIlifGlbWu+S1/9pqWPTzJ2+DcjwohbHzsDahhYewFhXgC8qsK0ypi/Shlp+CwRITyIvbVXESD0xz3YOTRHeZLlChvVqN8z4ZzN8nm0MXkmT1wcpYI73bH4KdnPwNU3s7XxvP/ernQP73SHHAOKSLlz4F6AEHFjJiCoXzeLF7LwEjRdxDJ0sKVXbRk3i9BGh+8Nle2VYgjpUWtk2763QkvZiQQ==",
        "expirationMonth": "12",
        "expirationYear": "20"
      },
      "token": "eb50a022-d6de-4244-a1e6-dcb8522b2d19",
      "processingOptions": {
        "checkFraud": true
      }
    }'
    
  5. Listen for Nexio's Response

    Follow step 8 of the Creating a save card page with the iframe tutorial. See the Kount Response page for more information about the possible results included in the response.

While running a transaction

  1. Configure Your Account

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

  2. Prepare the Iframe

    Follow steps 1-5 of the Creating a card checkout page with your own form tutorial.

  3. Post Card Information to Nexio

    Follow step 5 of the Creating a card checkout page with your own form tutorial.

    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
      }
    }'
    
  4. Create a Receipt for the Customer

    Follow step 6 of the Creating a card checkout page with your own form tutorial.

    See the Kount Response section for more information about the possible results included in the response.