Launch the Checkout

To launch the checkout, follow these steps:

From your server, call the Create Checkout Session API to create a checkout session.
- When calling the Create Checkout Session API, don’t pass the redirectUrl parameter. The SDK already handles the redirect automatically using the configuration file.
- Call the API from your server to ensure session integrity and security. Never invoke this endpoint from your client-side code.

After receiving the API response on your server, extract the values from the session object:

{
    "checkoutSessionToken": "session_token_identifier",
    "purchaseId": "pr_purchase_id",
    "url": "https://checkout-v2-sandbox.appcharge.com",
    "parsedUrl": "https://checkout-v2-sandbox.appcharge.com/session_token_identifier#boot=checkout_boot_data"
}

Parameter	Description
`checkoutSessionToken`	A unique token to identify and validate the checkout session.
`purchaseId`	ID to track the purchase.
`url`	The base URL of the Appcharge checkout page.
`parsedUrl`	The base URL with data configurations.

Use the values returned in the Create Checkout Session API response to open the checkout on the client, and pass your player’s customerId. The SDK uses this ID with the session purchaseId to validate the order if the player closes the browser during checkout and later returns to the game. It also identifies the correct player when multiple players share the same device.
BridgeAPI.openCheckout( purchaseId: "PURCHASE_ID", parsedUrl: "PARSED_URL", customerId: "CUSTOMER_ID" )
The session response values must be passed exactly as received. Modifying them may result in the checkout failing to load.
You can also configure how the checkout page is opened (optional):
// Open the checkout in the device’s default browser BridgeAPI.setBrowserMode("external") // Open the checkout with an internal Trusted Web Activity BridgeAPI.setBrowserMode("internal") // <-- Default
Running the checkout in an external browser may cause inconsistent behavior across devices and Android versions, including session loss, incomplete transactions, or app unexpected lifecycle behavior.

Overview

Checkout

Payment Links