Prerequisites: Authentication · Run a sale
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 integrationsupport@payroc.com.
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.