Enabling security code verification with your own form

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

  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. Include the object "processingOptions": { "verifyCvc": true } in the body of your request. (This is part of step 7a of the Creating a save card page with your own form tutorial, with the addition of the verifyCvc parameter in the processingOptions object.)

    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 '{
      "processingOptions": {
        "verifyCvc": true
      }
    }'
    

  3. Post Card Information to Nexio

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

    In the request, be sure to also include the card security code (as the securityCode parameter) as entered by the user.

    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 '{
      "token": "eb50a022-d6de-4244-a1e6-dcb8522b2d19",
      "card": {
        "cardHolderName": "John H Doe",
        "encryptedNumber": "cu3yRktaYFK2LUC6DpNK289tYDsGRCi7cO+GeG0hkeYFvT7Y8/oY5r53obMz6Q/BZ38gk2u2Ufwy8ojBcX2sfNjG5jplGTXA4NNlSIUjMFfiHe1sff1JFpThoiW/IIlifGlbWu+S1/9pqWPTzJ2+DcjwohbHzsDahhYewFhXgC8qsK0ypi/Shlp+CwRITyIvbVXESD0xz3YOTRHeZLlChvVqN8z4ZzN8nm0MXkmT1wcpYI73bH4KdnPwNU3s7XxvP/ernQP73SHHAOKSLlz4F6AEHFjJiCoXzeLF7LwEjRdxDJ0sKVXbRk3i9BGh+8Nle2VYgjpUWtk2763QkvZiQQ==",
        "expirationMonth": "12",
        "expirationYear": "20",
        "securityCode": 927
      }
    }'
    

  4. Listen for Nexio's Response

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

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