Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Token Merchant Checkout Sample: Javascript

This sample app shows how to integrate the Token Merchant Quick Checkout button into a merchant's website. You can learn more about the checkout buttons and relevant APIs at Token Request.


To install, npm install

To run, node server.js

This starts up a server.

The first time you run the server, it creates a new Member (Token user account). It saves the Member's private keys in the keys directory. In subsequent runs, the server uses this ID these keys to log the Member in.

The server operates in Token's Sandbox environment. This testing environment lets you try out UI and payment flows without moving real money.

The server shows a web page at localhost:3000. The page has a checkout button. Clicking the button starts the Token merchant payment flow. The server handles endorsed payments by redeeming tokens.

Test by going to localhost:3000.

This code uses a publicly-known developer key (the devKey line in the initializeSDK method). This normally works, but don't be surprised if it's sometimes rate-limited or disabled. If your organization will do more Token development and doesn't already have a developer key, contact Token to get one.

Implementing Cross Border payments

To allow TPPs to make better decision while selecting the destination account, we have an additional flow available for them.

For information on how to use it, go to the following link

Note: If SWIFT is used as the transfer destination type and the user selects a UK bank, then the account number should follow IBAN format.


If anything goes wrong, try to update the token SDK dependency:

npm update @token-io/tpp

Otherwise, email Token support:, or one of the Token engineers.


Very simple merchant checkout example



No releases published


No packages published