Save a customer's payment details

Important: Make sure that you have set up your Hosted Fields integration to run a sale. For more information, go to Run a sale.

When you use Hosted Fields to capture a customer’s payment details, we return a single-use token that represents the payment details. You can use the single-use token only once, and it expires 30 minutes after we return it.

If you want to save the customer’s payment details for a future payment or repeat payments, you need to convert the single-use token into a secure token. You can use the secure token more than once, and it doesn’t expire.

You can use the secure token as the payment method in follow-up transactions, for example:

  • Faster checkout - Link the secure token with the customer’s profile on your merchant’s website, so the customer doesn’t need to reenter their payment details for a future payment.

  • Repeat payments - Set up recurring payments so that a merchant can take payments from a customer on a regular schedule.

Using the secure token

After you receive the secure token that represents the customer’s payment details, you can use it in follow-up requests to our API, including:

Note: You can also use the secure token to set up repeat payments with our gateway, which requires more integration effort and cost. For more information, contact our Integrations Team at [email protected].

Use Hosted Fields to save a customer’s payment details

To extend your integration to save a customer’s payment details, go to one of the following guides: