Using the Account Registration Button on Order Confirmation Pages

Overview

The Account Registration Button allows guest shoppers who complete checkout through Global-e to register for your store account directly from the Order Confirmation page.

When the shopper clicks the button, Global-e passes customer and order details to your site via a JavaScript callback/postMessage. You then handle the registration flow, event tracking, and redirect on your side.

Business Value

Increase account registrations from first-time guest shoppers.
Improve retention and repeat purchases.
Maintain a seamless shopper experience—no redirects from Global-e, no checkout regressions.

What Merchants Need to Do

To enable and implement the Account Registration Button

Step 1 – Enable the Feature
Request Global-e to enable the “Registration Button on Confirmation Page” in your MAS configuration.
The button is only displayed for guest shoppers (non-signed-in users).

Step 2 – Handle the Callback Event

Global-e sends a client-side event (OnCustomerRegistration) when the shopper clicks the button. You must listen to this event in your website’s parent page and implement a handler.

// Define your registration handler
const registrationHandler = function (data) {
    console.log('🎉 Customer Registration Event Received!');
    console.log('Registration Data:', data);

    // Example: access key fields
    console.log('Customer:', data.firstName, data.lastName);
    console.log('Email:', data.email);

    // Process data according to your needs:
    // 1. Redirect shopper to your registration page
    // 2. Pre-fill registration form fields
    // 3. Send event to analytics tools
    // 4. Store in your CRM / ERP if needed
};

// Register the handler in Global-e client SDK
GlobalE.OnCustomerRegistration(registrationHandler);

Step 3 – Process the Data

The callback contains customer, billing, and shipping details in JSON format.

{
  "countryCode": "US",
  "firstName": "John",
  "lastName": "Smith",
  "email": "[email protected]",
  "phoneNumber": "+1-555-123-4567",
  "billingAddress": {
    "BillingFirstName": "John",
    "BillingLastName": "Smith",
    "BillingAddress1": "123 Main Street",
    "BillingCity": "New York",
    "BillingZIP": "10001",
    "BillingCountryCode": "US"
  },
  "shippingAddress": {
    "ShippingFirstName": "John",
    "ShippingLastName": "Smith",
    "ShippingAddress1": "456 Oak Avenue",
    "ShippingCity": "Brooklyn",
    "ShippingZIP": "11201",
    "ShippingCountryCode": "US"
  }
}

Use this data to:

Pre-fill registration forms on your site.
Pass data to your customer account system.
Fire analytics/marketing events.

Step 4 – Manage Redirect and Tracking
Global-e does not perform redirects. You are responsible for:
- Redirecting shoppers to your registration page.
- Implementing your own event tracking.
Step 5 – Localization and Styling
Button text is localized via Global-e’s translation layer (TR_REGISTER_FROM_CONFIRMATION).
UI style matches your confirmation page design automatically.
No action is needed unless you want to apply custom CSS.

Shopper Experience

Guest completes checkout.
On the Confirmation page, the shopper sees: [Create an Account] button.
Shopper clicks button → OnCustomerRegistration event triggers.
Your site handles registration redirect and tracking.

Merchant Checklist

Task	Who Handles	Notes
Enable MAS setting for Registration Button	Global-e	One-time setup
Implement event listener (`OnCustomerRegistration`)	Merchant	Required
Process customer and order data	Merchant	Use payload fields
Redirect to registration	Merchant	Required

Example Use Cases

Pre-fill Registration Form
Shopper clicks the button → your form loads with name, email, and address already filled in.
Custom Redirect
Shopper is redirected to /register?source=confirmation with their email passed as a query parameter.

With this setup, you fully control shopper registration flow while leveraging Global-e checkout context.

Documentation Portal