Skip to main content
In addition to React components, Loop Connect offers native Web Components that provide identical functional, with broader environmental compatibility. For a more detailed explanation of usage, functionality, and types, refer to the LoopConnectPayIn component page.

​
Collect payment

Loop Connect’s pay-in web component renders a customizable UI for users to connect their wallet, select their token, and complete the payment authorization process. 
<loop-connect-pay-in 
    payment-usd-amount="199">
</loop-connect-pay-in>

​
Attributes

The following table maps the custom attributes available for the loop-connect-pay-in web component to the cooresponding properties of the standard React component.
Attribute nameEquivalent React property
payment-usd-amount (required)paymentUsdAmount
minimum-authorization-usd-amountminimumAuthorizationUsdAmount
suggested-authorization-usd-amountsuggestedAuthorizationUsdAmount
customer-ref-idcustomerRefId
subscription-ref-idsubscriptionRefId
invoice-ref-idinvoiceRefId
await-confirmationawaitConfirmation
state-notificationstateNotification
failure-notificationfailureNotification
confirming-notificationconfirmingNotification
complete-notificationcompleteNotification
authorized-notificationauthorizedNotification
custom-stylescustomStyles
disableddisabled
disable-submitdisableSubmit
bill-datebillDate
Details on each attribute can be found in sections for payment details, notifications, and styling.

​
PayIn events

The loop-connect-pay-in component also allows optional event callback handlers to be configured, just as the React component does. The callback functions take the form ({ detail: EventType }) => void, where detail is within the CustomEvent callback object. Here, EventType is used as a placeholder to represent the individually defined type for each event. The specification for each event type can be found documented along with the React version of this component.
Custom eventHandler attribute / propertyCallback object type
readyonreadyPayInReadyEvent
readyfailedonreadyfailedPayInReadyFailedEvent
tokenchangeontokenchangePayInTokenChangeEvent
statechangeonstatechangePayInStateChangeEvent
authorizationupdatedonuthorizationdpdatedPayInAuthorizationUpdatedEvent
customercreatedoncustomercreatedPayInCustomerCreatedEvent
createdoncreatedPayInCreatedEvent
confirmedonconfirmedPayInConfirmedEvent
failureonfailurePayInFailedEvent
Additional details on each event and its return type can be found in the PayIn events section. As with the React version of this component, the events walletchange and networkchange can also both be captured using onwalletchange and onnetworkchange respectively from the Web Component, in addition the handlers passed to initLoopConnect() outlined on the initialization page.

​
Custom event listener

Listen to the component for custom events by selecting the element and calling its native addEventListener method to attach a listener that executes and receives a data object when the event has been triggered. 
<loop-connect-pay-in 
    id="payin"
    payment-usd-amount="199">
</loop-connect-pay-in>

<script>
    // Select the component by its "id" attribute
    const payin = document.getElementById('payin');

    // Define the event handler function
    const handlePayInReady = (event) => console.log('The payin component is ready.', event);

    // Add an event listener and attach the handler function
    payin.addEventListener('ready', handlePayInReady);
</script>

​
Event handler property

As in standard in Javascript, event handlers can be assigned directly to the selected element’s event handler properties. 
<loop-connect-pay-in 
    id="payin"
    payment-usd-amount="199">
</loop-connect-pay-in>

<script>
    // Select the component by its "id" attribute
    const payin = document.getElementById('payin');

    // Define the event handler function
    const handlePayInReady = (event) => console.log('The payin component is ready.', event);

    // Assign the event listener to the `onready` property
    payin.onready = handlePayInReady;
</script>

​
Event handler attribute

Likewise, an event handler function can be assigned to the component in HTML using an event handler attribute without the need to select the component. 
<script>
    // Define the event handler function, which will be assigned to the 'onready' attribute in html
    const handlePayInReady = (event) => console.log('The payin component is ready.', event);
</script>

<loop-connect-pay-in 
    payment-usd-amount="199"
    onready="handlePayInReady(event)">
</loop-connect-pay-in>

​
Quickstart examples

Below are a few examples in common JS frameworks that implement the “PayIn” component, adding a listener for the statechange event. 
<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>Loop Connect</title>
        <script type="module">
            import { initLoopConnect } from '@loop-crypto/connect';

            initLoopConnect({
                apiKey: "your-apiKey-here",
                entityId: "your-entityId-here",
                merchantId: "your-merchantId-here",
            });
        </script>
    </head>
    <body>
        <loop-connect-pay-in
            id="payIn"
            payment-usd-amount="100"
        ></loop-connect-pay-in>
        <script>
            const payIn = document.getElementById("payIn");
            payIn.addEventListener('statechange', (event) => { 
                console.log(`State changed: ${event.detail.message}`);
            })
        </script>
    </body>
</html>
⌘I