One-Time Token

Generate single-use card tokens for secure payments in Bamboo. Ideal for anonymous checkouts or quick purchases. Valid for 10 minutes.

A One-Time Token (OTT) allows capturing card data securely for a single purchase without storing sensitive information. It is ideal for one-time transactions where the customer is not registered or when the card should not be saved for future use.

OTTs are valid for 10 minutes and can be used only once.



How OTTs Are Generated

One-Time Tokens are automatically created when capturing card data through:

⚠️

Do not include a CustomerId when generating a One-Time Token. If provided, the token will be created as a Recurring Token instead.



How to Use the One-Time Token

Once the OTT is generated, it must be sent to your backend and used in the TrxToken field when creating a purchase. Refer to the Create a Purchase guide for details on how to include the token in the purchase request.

🖼️

To visualize the full end-to-end tokenization flow, including how the OTT is created and used in a payment, see the Tokenization Form guide.


Best Practices

  • Use OTTs only for anonymous or one-time transactions.
  • Always send the token to your server immediately after generation.
  • Complete the purchase within 10 minutes of generating the token.
  • Do not attempt to reuse an OTT. It is single-use by design.
  • Avoid exposing the OTT in the frontend once generated.


Next Steps