Using the Account Registration Button on Order Confirmation Pages

Overview

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

1. 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).
2. 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);
   
3. Step 3 – Process the Data The callback contains customer, billing, and shipping details in JSON format.
   {
     "countryCode": "US",
     "firstName": "John",
     "lastName": "Smith",
     "email": "john.smith@example.com",
     "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.
4. 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.
5. 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

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

Merchant Checklist

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.