Create single use token
Use this method to create a single-use token that represents a customer’s payment details.
A single-use token expires after 30 minutes and merchants can use them only once.
**Note:** To create a reusable permanent token, go to [Create Secure Token](https://docs.payroc.com/api/schema/payments/secure-tokens/create).
In the request, send the customer’s payment details. If the request is successful, our gateway returns a token that you can use in a follow-on action, for example, [run a sale](https://docs.payroc.com/api/schema/payments/create).
Path parameters
processingTerminalId
Unique identifier that our gateway assigned to the terminal.
Headers
Authorization
Bearer authentication of the form `Bearer <token>`, where token is your auth token.
Idempotency-Key
Unique identifier that you generate for each request. You must use the [UUID v4 format](https://www.rfc-editor.org/rfc/rfc4122) for the identifier. For more information about the idempotency key, go to [Idempotency](https://docs.payroc.com/api/idempotency).
Request
This endpoint expects an object.
channel
Channel that the merchant used to receive the payment details.
Allowed values:
source
Object that contains information about the payment method to tokenize.
operator
Operator who initiated the request.
Response
Successful request. We created the single-use token.
processingTerminalId
Unique identifier that we assigned to the terminal.
token
Unique identifier that our gateway assigned to the payment details.
**Note:** Merchants can use the token with other terminals linked to their account.
expiresAt
Date and time that the token expires. We return this value in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
source
Object that contains information about the payment method that we tokenized.