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:
- Create a card payment
- Create a bank transfer payment
- Update a customer’s payment details with Hosted Fields
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:
-
Save payment details when running a sale - Take payment from the customer and store their payment details in the same transaction.
-
Save payment details without running a sale - Store a customer’s payment details without charging the customer.