Payment tokens

A payment token can only be created using a secret key. It is a snapshot of payment information that securely isolates the transaction value and currency of a payment.

Payment tokens expire after 15 minutes. If a payment is not completed in that time, its Payment Token will no longer be available to use.

We advise adding optional custom metadata (e.g. order number) to a payment token, which can be later used to verify the authenticity of a transaction further.

Payment token object

Field name
Description

id
String

The unique identifier of a payment token (prefixed with paytok).

livemode
Boolean

  • true if live keys were used in the request.
  • false if test keys were used in the request.

Can we help?

Thanks for using Checkout.com. If you need any help or support, then message our support team at support@checkout.com.