Get Started

The JS bridge using forms communication is available from Platform v19.0 and is the recommended communication method. This guide walks through the steps required to set up the forms bridge on the frontend.

Set up the Web Checkout

1. Ensure the SDK and Platform are set up following the PoqSDK set up steps.
2. Add the PoqWebCheckout framework to your project following these steps.

Set up the JS Bridge

The app sets the following cookies when loading the checkoutUrl so that the website script can download the correct version of the JS bridge. These settings can be specified as a different type but the defaults should not need changing.

• poq.webcheckout.platform to ios.
• poq.webcheckout.version to the bridge version set by the app (default 7.0.0).
• poq.webcheckout.integrity to the bridge integrity set by the app.

Setting up the JS bridge requires a web developer, but it is likely you'll be involved in debugging so follow these steps.

1. Have a web developer follow these JS bridge set up steps.
2. Read and understand the JS bridge communication overview.

Use a different Web Checkout type

The Web Checkout can be set up using different configurations. However, it is important to note that the forms communication is by far the best, easiest to implement, and least conflicting communication method.

Container.shared.coordinators.webCheckout.replace {
    PoqWebCheckoutCoordinator {
        // Set custom version and integrity values for forms communication.
        WebCheckoutBuilder(type: .bridge(configuration: .init(
            version: ...,
            integrity: ...,
            communicationMethod: .forms,
            applePay: nil
        )))
    }
}

Next steps

• Study the JS bridge communication overview.