Tagging a new card for exclusion

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

You can tag a new card for exclusion using any of the following methods:

With the iframe

  1. Prepare the Iframe

    Follow steps 1-2 of the Creating a save card page with the iframe tutorial or the Creating a card checkout page with the iframe tutorial.

  2. Request a One-time-use Token

    Request an e-commerce one-time-use token.
    Include the parameter shouldUpdateCard: false in the body of your request.

    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 '{
  "shouldUpdateCard": false
}'

  3. Load the Iframe

    Follow steps 4-6 of the Creating a save card page with the iframe tutorial or the Creating a card checkout page with the iframe tutorial.

    Now, when the iframe is loaded a Kount check will be performed.

    Nexio will return the results back to you in the Kount response.

With your own form

  1. Prepare the Iframe

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

  2. 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 your own form 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 '{}'

  3. Post Card Information to Nexio

    Follow step 7b of the Creating a save card page with your own form tutorial.

    Include the parameter shouldUpdateCard: false 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",
  "shouldUpdateCard": false
}'

  4. Listen for Nexio's Response

    Follow step 8 of the Creating a save card page with your own form tutorial.

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

With the API

  1. 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 '{}'

  2. 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 parameter shouldUpdateCard: false 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",
  "shouldUpdateCard": false
}'

Updated 9 days ago