Integration Process

Start the transaction by making a create-intent POST request to xPay’s API from the Merchant Server, which returns an fwdUrl in the response. See create-intent API for details.

Once the payment intent is created, the xPay Server will respond with an xIntentId, which is used to track the payment status throughout the transaction.

The Merchant Server forwards the intent data with fwdUrl to the Merchant Frontend, enabling it to manage user interactions related to the payment.

Redirect the user to xPay’s checkout page to initiate the payment using the fwdUrl.

const redirectToCheckout = () => {
    const url = new URL(fwdUrl); // fwdUrl received from your server after creating an intent
    window.open(url.href).focus();
};

• Build a client-side page to receive the redirect and show the payment status.
• After the payment process, customers will be redirected to the callbackUrl with the query parameter xpay_intent_id.
• The Merchant Frontend contacts the Merchant Server, which invokes the get-intent GET request to retrieve the status and other metadata for the specified intent. See get-intent API for details.

const onPageLoad = async () => {
    const url = new URL(window.location.href);
    const intentId = url.searchParams.get("xpay_intent_id");

    const intent = await getIntentStatus(intentId, metadata); // From the Merchant Server
    if(intent.status === "SUCCESS") {
        // redirect to your payment success page
    } else {
        // redirect to your payment failure page
    }
};