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

• With the iframe
• With your own form
• With the API

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.

   Example 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.)

   Example

   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.

   Example

   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.

   Example 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 '{}'
   

   
   

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.

   Example 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
   }'