Payment Tokens Configuration

Merchants can choose which tokens and networks they want to accept payments in. For convenience, merchants can configure a Default Token List that applies to all payment links by default. Merchants can also override this default by specifying tokens for individual payment links.

You can see our list of Supported Networks & Tokens. If you need a token that isn't currently supported, please reach out to our team.

Technical Details

Setting the Default List

paymentTypes define the tokens and networks a merchant is willing to accept.

• Setting a paymentType to isDefault: true adds that token and network to your default list
• You can have multiple tokens on multiple networks in your default list

Important behaviors:

• When the default list is updated, any payment links using the default list will update immediately
• If a payment link page is currently open, it will refresh within 10 minutes to reflect these changes
• If no default tokens are set, you cannot create payment links that rely on the default list, but you can still create links with explicitly defined tokens
• If you add a token on a network where you do not have a payout destination configured, the token will be added but you will not be able to create a payment link with that token

Creating a Checkout Session

Using defaults:

• If the paymentTokens parameter is blank or omitted, the checkout link will use your default token list

Overriding defaults:

• Passing specific tokens/networks to the paymentTokens parameter will override the default list
• Only the specified tokens/networks will be accepted by that link

Updating links:

• Links can be modified using the update checkout session endpoint to change accepted tokens/networks

No-Code Configuration

• Merchants can set their default token list on the Company Dashboard on the Company Settings page. Loop allows you to pick from the list of all Loop supported tokens for the networks that you have configured.
• When creating individual payment links, Merchants can optionally select specific tokens to override the default list.