Loop allows merchants to self-serve to our developer sandbox environment for free.

For production accounts, please reach out to Loop at [email protected]. For our Starter plan, we will provide you with a code to get started.

You can follow these steps directly in ReadMe to get started.

Requirements

You will need a Restricted API key from Stripe. Here are directions on how to create one.

Networks & Tokens

On Production Loop support any EVM Network and Solana.

On our Sandbox/Demo environment, only Sepolia is supported. You can find a list of supported tokens here.

Environments

Environment	API URL
Production	https://api.loopcrypto.xyz
Demo	https://demo.api.loopcrypto.xyz

Directions: Production

There are 2 steps.

1. Create your Loop Account using the Create entity endpoint

Here you can create your Loop account. You will need a code that is provided to you by the Loop team after payment.

From the response, save the API Key and Entity ID, you will need both to make the rest of the calls below. This key will be named Default Admin Key. You can use the List API Keys endpoint to see the permissions it has.

Input	Description
code	Loop will provide this code to you
entityName	This is your company name. It will be shown on all your payment links
email	The email address that will be used to create an administrator account, granting full access to manage the company's settings and configurations through the web portal. You need access to this email as login is done by sending a code to your email.
logoUrl (optional)	You can provide a link to your logo that will be displayed on your payment links.
paymentTypes	Defines the networks and tokens you are willing to to accept. networkId: Only EVMs can be set up with this endpoint. Please reach out to Loop if you would like us to add Solana. settlementType: If you chose to settle in fiat, please use the payoutDestinations: The blockchain wallet addresses where payments will be sent if the settlement type is crypto. An address per network is required. tokens: the tokens you are willing to accept on each network you've enabled. You can pass in token symbols like USDC or USDT. You can find a list of supported tokens and their symbols here. You must set at least one token. You will be able to add more tokens later.
fiatSettlementSettings	The configuration settings specifically for fiat settlement. Only required if you choose settlementType: fiat. Please follow directions here on how to finish setting up your fiat settlement. customerType: This is required to define if you will need to conduct KYB or KYC. For individuals, you will need to provide your full name. email: Defaults to the merchant's email address if not provided.

2. Connect Loop & Stripe

Use the Connect Stripe endpoint under Stripe Integrations and pass in the Restricted API key you created in the requirements section.

You're all set! Loop has now been added as a payment method for your Stripe account

Directions: Demo

There are 2 steps.

1. Create your Loop Account using the Create entity endpoint

Here you can create your Loop account.

All demo environment API calls begin with demo.api. You can toggle to the demo base URL in readme.

Input	Description
entityName	This is your company name. It will be shown on all your payment links
email	The email address that will be used to create an administrator account, granting full access to manage the company's settings and configurations through the web portal. You need access to this email as login is done by sending a code to your email.
logoUrl (optional)	You can provide a link to your logo that will be displayed on your payment links.
paymentTypes	Defines the networks and tokens you are willing to to accept. networkId: Only Sepolia (11155111) is supported settlementType: Only crypto settlement is supported payoutDestinations: The blockchain wallet addresses where payments will be sent if the settlement type is crypto. If you do not have a wallet address, you can use the example value (0x1B3181390bfCb83A98369f660d11c6d73345f60d) tokens: the tokens you are willing to accept on each network you've enabled. You can pass in token symbols like USDC or USDT. You can find a list of supported tokens and their symbols here. You must set at least one token. You will be able to add more tokens later.
fiatSettlementSettings	Fiat settlement is not supported on demo.

2. Connect Loop & Stripe

Use the Connect Stripe endpoint under Stripe Integrations and pass in the Restricted API key you created in the requirements section.

You're all set! Loop has now been added as a payment method for your Stripe account**

Next steps

You can add other users to your dashboard using the add users endpoint with the following roles:
- company - Will have admin privileges
- company_read- Can only read data on the dashboard
Please note, the user will not be notified that they have been added. You will need to tell them to login to the company dashboard with the email address you provided.
Login and explore the Company Dashboard at admin.loopcrypto.xyz (sandbox environment at demo.admin.loopcrypto.xyz . The first time you login you will be asked to set up 2FA
Learn how to set default tokens here.
Learn how to create your first payment link for subscriptions or one-time product sales
Learn how to get paid for one-off invoices not tied to a subscription here
Learn how what happens after a payment takes place
Learn how to handle upgrades, downgrades, and cancellations
Learn how Loop handles renew payments
Learn about how Loop helps you collect payments with our customer notifications
Learn how refunds are handled
Learn how you can settle in fiat
Learn about how to handle Webhooks here