{"title":"Testing tokenization","category":"default","creationDate":1779533780,"content":"

You can use our Tokenization feature<\/a> to store payment details for transactions like automatic subscription renewal payments.<\/p>\n

Test your integration with Adyen's tokenization features, using our test card numbers<\/a>. The following steps take you through the different steps for storing, using, updating, and removing payment details.<\/p>\n

    \n
  1. Store payment details for one-off payments<\/a><\/li>\n
  2. Make a test one-off payment with stored payment details<\/a><\/li>\n
  3. Store payment details for subscription payments<\/a><\/li>\n
  4. Make a test subscription payment with stored payment details<\/a><\/li>\n
  5. Update stored payment details<\/a><\/li>\n
  6. Remove stored payment details<\/a><\/li>\n<\/ol>\n

    Additionally, you can optionally test Real Time Account Updater scenarios<\/a> if you use the feature.<\/p>\n

    Step 1: Store payment details for one-off payments<\/h2>\n

    Test storing payment details for one-off payments<\/a>.<\/p>\n

      \n
    1. \n

      Create a token with an amount of 0<\/strong> (zero-auth transaction). In your API request, set the following parameters:<\/p>\n\n\n\n\n\n\n
      Parameter<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
      shopperInteraction<\/code><\/td>\nEcommerce<\/strong><\/span><\/td>\n<\/tr>\n
      recurringProcessingModel<\/code><\/td>\nCardOnFile<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n
    2. \n

      Get the recurring.token.created<\/a> webhook.<\/p>\n<\/li>\n

    3. \n

      Store the token from the webhook and the shopper reference for test one-off payments.<\/p>\n<\/li>\n<\/ol>\n

      Step 2: Make a test one-off payment<\/h2>\n

      Test making a one-off payments with stored payment details.<\/p>\n

        \n
      1. \n

        Make a test one-off payment with the token you created for testing<\/a>. In your API request, set the following parameters:<\/p>\n\n\n\n\n\n\n
        Parameter<\/th>\nValue<\/th>\n<\/th>\nParameter<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
        shopperInteraction<\/code><\/td>\nContAuth<\/strong><\/span><\/td>\n<\/tr>\n
        recurringProcessingModel<\/code><\/td>\nCardOnFile<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n
      2. \n

        Get the AUTHORISATION<\/strong><\/span> webhook<\/a> on your server. It includes the status of the payment.<\/p>\n<\/li>\n<\/ol>\n

        Step 3 (optional): Store payment details for subscription payments<\/h2>\n

        If you accept subscription payments, test storing payment details for subscription payments<\/a>.<\/p>\n

          \n
        1. \n

          Create a token with an amount of 0<\/strong> (zero-auth transaction). In your API request, set the following parameters:<\/p>\n\n\n\n\n\n\n
          Parameter<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
          shopperInteraction<\/code><\/td>\nEcommerce<\/strong><\/span><\/td>\n<\/tr>\n
          recurringProcessingModel<\/code><\/td>\nSubscription<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n
        2. \n

          Get the recurring.token.created<\/a> webhook.<\/p>\n<\/li>\n

        3. \n

          Store the token from the webhook and the shopper reference for test subscription payments.<\/p>\n<\/li>\n<\/ol>\n

          Step 4 (optional). Make a test subscription payment<\/h2>\n

          If you accept subscription payments, test making a subscription payment with stored payment details.<\/p>\n

            \n
          1. \n

            Make a test one-off payment with the token you created for testing<\/a>. In your API request, set the following parameters:<\/p>\n\n\n\n\n\n\n
            Parameter<\/th>\nValue<\/th>\n<\/tr>\n<\/thead>\n
            shopperInteraction<\/code><\/td>\nContAuth<\/strong><\/span><\/td>\n<\/tr>\n
            recurringProcessingModel<\/code><\/td>\nSubscription<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n
          2. \n

            Get the AUTHORISATION<\/strong><\/span> webhook<\/a> on your server. It includes the status of the payment.<\/p>\n<\/li>\n<\/ol>\n

            Step 5. Update stored payment details<\/h2>\n

            Test updating stored payment details<\/a>.<\/p>\n

              \n
            1. Make a request to update<\/a> stored payment details for one of the tokens you created for testing.<\/li>\n
            2. Get the stored<\/a> for the shopper reference you stored the token with.<\/li>\n<\/ol>\n

              Step 6. Remove stored payment details<\/h2>\n

              Test deleting stored payment details<\/a>. Make a request to delete stored payment details for one of the tokens you created for testing.<\/p>\n

              Real Time Account Updater scenarios<\/h2>\n

              To test how different Real Time Account Updater scenarios work for your integration, use the following test card numbers and expiry dates in your payment request. The response will contain the corresponding status in the additionalData.realtimeAccountUpdaterStatus<\/code> field.<\/p>\n\n\n\n\n\n\n\n\n
              Card number<\/th>\nExpiry month\/year<\/th>\nStatus<\/th>\n<\/tr>\n<\/thead>\n
              5454 5476 9908 4950<\/td>\n03\/2030<\/td>\nCardChanged<\/strong><\/td>\n<\/tr>\n
              5454 5418 5840 6567<\/td>\nAny date except 03\/2030<\/td>\nCardExpiryChanged<\/strong><\/td>\n<\/tr>\n
              5454 5415 8031 1093<\/td>\n03\/2030<\/td>\nCloseAccount<\/strong><\/td>\n<\/tr>\n
              4111 1131 5971 2925<\/td>\n03\/2030<\/td>\nContactCardAccountHolder<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
              \n

              If you are not fully PCI compliant and thus unable to process raw card data, add a prefix of test_<\/code> to the credentials. For example, use \"encryptedCardNumber\": \"test_5454547699084950\"<\/code>. This allows you to test using encrypted card details<\/a>.<\/p>\n<\/div><\/div>","url":"https:\/\/docs.adyen.com\/development-resources\/testing\/tokenization","articleFields":{"description":"Test the tokenization with your integration and troubleshoot issues before it goes live.","cache_enable":false},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/testing\/tokenization","title":"Testing tokenization","content":"You can use our Tokenization feature to store payment details for transactions like automatic subscription renewal payments.\nTest your integration with Adyen's tokenization features, using our test card numbers. The following steps take you through the different steps for storing, using, updating, and removing payment details.\n\nStore payment details for one-off payments\nMake a test one-off payment with stored payment details\nStore payment details for subscription payments\nMake a test subscription payment with stored payment details\nUpdate stored payment details\nRemove stored payment details\n\nAdditionally, you can optionally test Real Time Account Updater scenarios if you use the feature.\nStep 1: Store payment details for one-off payments\nTest storing payment details for one-off payments.\n\n\nCreate a token with an amount of 0 (zero-auth transaction). In your API request, set the following parameters:\n\n\n\nParameter\nValue\n\n\n\n\nshopperInteraction\nEcommerce\n\n\nrecurringProcessingModel\nCardOnFile\n\n\n\n\n\nGet the recurring.token.created webhook.\n\n\nStore the token from the webhook and the shopper reference for test one-off payments.\n\n\nStep 2: Make a test one-off payment\nTest making a one-off payments with stored payment details.\n\n\nMake a test one-off payment with the token you created for testing. In your API request, set the following parameters:\n\n\n\nParameter\nValue\n\nParameter\nValue\n\n\n\n\nshopperInteraction\nContAuth\n\n\nrecurringProcessingModel\nCardOnFile\n\n\n\n\n\nGet the AUTHORISATION webhook on your server. It includes the status of the payment.\n\n\nStep 3 (optional): Store payment details for subscription payments\nIf you accept subscription payments, test storing payment details for subscription payments.\n\n\nCreate a token with an amount of 0 (zero-auth transaction). In your API request, set the following parameters:\n\n\n\nParameter\nValue\n\n\n\n\nshopperInteraction\nEcommerce\n\n\nrecurringProcessingModel\nSubscription\n\n\n\n\n\nGet the recurring.token.created webhook.\n\n\nStore the token from the webhook and the shopper reference for test subscription payments.\n\n\nStep 4 (optional). Make a test subscription payment\nIf you accept subscription payments, test making a subscription payment with stored payment details.\n\n\nMake a test one-off payment with the token you created for testing. In your API request, set the following parameters:\n\n\n\nParameter\nValue\n\n\n\n\nshopperInteraction\nContAuth\n\n\nrecurringProcessingModel\nSubscription\n\n\n\n\n\nGet the AUTHORISATION webhook on your server. It includes the status of the payment.\n\n\nStep 5. Update stored payment details\nTest updating stored payment details.\n\nMake a request to update stored payment details for one of the tokens you created for testing.\nGet the stored for the shopper reference you stored the token with.\n\nStep 6. Remove stored payment details\nTest deleting stored payment details. Make a request to delete stored payment details for one of the tokens you created for testing.\nReal Time Account Updater scenarios\nTo test how different Real Time Account Updater scenarios work for your integration, use the following test card numbers and expiry dates in your payment request. The response will contain the corresponding status in the additionalData.realtimeAccountUpdaterStatus field.\n\n\n\nCard number\nExpiry month\/year\nStatus\n\n\n\n\n5454 5476 9908 4950\n03\/2030\nCardChanged\n\n\n5454 5418 5840 6567\nAny date except 03\/2030\nCardExpiryChanged\n\n\n5454 5415 8031 1093\n03\/2030\nCloseAccount\n\n\n4111 1131 5971 2925\n03\/2030\nContactCardAccountHolder\n\n\n\n\nIf you are not fully PCI compliant and thus unable to process raw card data, add a prefix of test_ to the credentials. For example, use \"encryptedCardNumber\": \"test_5454547699084950\". This allows you to test using encrypted card details.\n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Testing your online payments integration","lvl3":"Testing tokenization"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"https:\/\/docs.adyen.com\/development-resources\/testing","lvl3":"\/development-resources\/testing\/tokenization"},"levels":4,"category":"Development Resources","category_color":"green","tags":["Testing","tokenization"]}}