How links work technically
One-time payments and subscriptions
Payment links combines an entity's entityId
with the unique itemId
of one or more products to be shown in the cart. In the case of child entities, each entity will have their own entityId
and thus checkout page.
Loop's standard format is:
https://checkout.loopcrypto.xyz/><entity-id>/<item-id>
You can also find product's full URL on the company dashboard or by retrieving it via API with the POST items and GET Items calls.
Payment links for a multi-product purchase
You can append multiple itemIds
together so that one payment link results in the purchase of multiple products. This includes combining multiple subscription products, one-time purchases or a combination of both (i.e. subscription(s) with one or many one-time payment). When combining multiple subscriptions, they must have the same billing frequency (i.e. monthly, yearly, etc.).
For example:
<https://checkout.loopcrypto.xyz/><entity-id>/<item-id>?item_id=<item_id>,<item_id>,...
Since you will need the itemIds
you will first have to create the product in Loop using the POST Items endpoint or retrieve an existing item using the GET Items endpoint.
Customizing payment links
Loop has several additional parameters that can be passed into the URL to customize the checkout experience.
Invoices
Payment links for invoices have a single static payment link address that can be included in all invoices.
https://checkout.loopcrypto.xyz/<entity-id>
Payers type in the invoice number and amount due (inclusive of any taxes, discounts, quantities, etc) to authenticate into the invoice and pay the bill.
Merchants can pre-populate the payment link so that it takes the customer directly to their unique checkout page.
https://checkout.loopcrypto.xyz/<entity-id>?invoiceId=<invoice_number>&invoiceAmount=<invoiceamount>
Note that if you are using Loop's integration with Stripe that Stripe does not create an invoice number until after an invoice is finalized.
Updated about 1 month ago