Skip to content
payrocdevelopers

Secure tokens

Reference for the secure token endpoints, covering how to create, retrieve, list, update, and delete a token that represents a customer's saved payment details.

Browse API reference

Use our Secure Tokens endpoints to create and manage a

secure token

that represents a customer’s payment details. Merchants can use the token to run transactions instead of using the customer’s card or bank details, and they can also store the token without additional

PCI compliance

requirements.

Integrate with the Create Secure Token method to create a secure token. You can then include the token in requests to our gateway, for example, to run a sale or to subscribe a customer to a payment plan.

When you create a token, you generate and include a secureTokenId to identify it. You can then use the secureTokenId to manage the token, including the following:

Retrieve the details of a token

Integrate with our Retrieve Secure Token method to view a token, the customer’s payment details, and the

Merchant Initiated Transaction (MIT)

agreement.

Integrate with our List Secure Tokens to return a paginated list of secure tokens that meet specific query requirements.

Update a token

Note: If you’re using our

Hosted Fields

solution, integrate with the Update Account Details method to update a secure token with the details from a

single-use token

.

Integrate with our Update Secure Token method to update the customer’s saved payment details. You can update:

  • Card or bank account details
  • MIT agreement
  • Customer’s contact details
  • Customer’s address details

Delete a token

Integrate with our Delete Secure Token method to permanently delete a secure token from our

vault

.

Search documentation

API reference169
Guides118
Knowledge38
legal1
Solutions32
Workflows74
↑↓highlight↵openView all search results

Menu

Theme

Sign out

Your saved plans remain in your organization. This browser’s private draft and account view will be cleared.

Talk to an engineer