LogoLogo
MerchantsHelpSign in
  • Overview
    • Countries & Currencies
    • Glopal Solutions Portfolio
  • Getting started
    • Shopify
      • Glopal Duty & Tax for Shopify
      • Shopify Collaborator Access
    • BigCommerce
    • Magento (Adobe Commerce)
      • Magento 1
      • Magento 2
        • Magento Activation
        • Magento Configuration
        • Magento Database Model
    • Visualsoft
    • PrestaShop
  • Marketing Solutions
    • Acquisition channels
      • Integrate Google Ads
      • Integrate Facebook Ads
    • Feed localization
      • Read domestic items
      • Localize the items
      • Upload the localized items
    • Features / Customization
      • Google Shopping countries coverage
      • Filters
      • Free listings
      • Comparison Shopping Services (CSS)
    • Google Ads
      • Conversion tracking
      • Standard accounts structure
      • Launching and monitoring Google Ads campaigns
    • Facebook
      • Facebook & Instagram Shops
      • Catalog Based Campaigns
      • Conversion and Brand awareness campaigns
      • Facebook conversion tracking
    • Email marketing
  • Localization
    • Site localization
      • Content localization
      • Price localization
      • Site search
      • Checkout
      • User account
    • Site discovery
      • Domains and Routing
      • Search engine optimization
      • Geo-localization
      • Country selector
    • Content distribution
      • Site security
      • Domains (DNS)
      • Traffic Splitting
        • Akamai
        • Cloudflare
        • Nginx
        • Microsoft IIS
        • AWS CloudFront
        • Magento Cloud
      • Third-party CDN
        • Cloudflare
      • Site speed
    • Integrations
      • CSS customizations
      • JavaScript customizations
      • Server-side customizations
      • Exclude from localization
      • Integration examples
        • Hiding Products
        • Newsletter Signup
        • Custom Price Logic
  • Checkout
    • Localized checkout
      • Overview
      • Styling
      • Integration
        • Callback Functions
        • Confirmation Page
        • Checkout Analytics
        • Allowlisting Glopal IPs
      • Price localization
    • Order processing
      • Order creation
        • Plug & Play integration
        • Order API
        • Event webhook
        • Custom Integration
      • Cancellation & refund
      • Returns
      • Buyer's communication
      • Customer account
    • Financials
      • EU VAT
  • DUTY & TAXES
    • Product Classification
    • Duty & Tax Calculation
      • Product Pricing
      • Supported Countries
    • Compliance Checks
      • Prohibited Goods
      • Denied Party Screening
  • SHIPPING
    • Order Creation
    • Label Generation
    • Manifest
    • Tracking
  • Translations
    • Translation Editor
  • MERCHANT ACCOUNT
    • Dashboards
      • SEO dashboard
  • What's New
    • Release Notes
Powered by GitBook
On this page
  1. Checkout
  2. Localized checkout

Integration

PreviousStylingNextCallback Functions

Last updated 10 months ago

In order to offer international checkout to your buyers, Glopal will have to interact with a cart during a customerโ€™s session. This is the main integration point. This section describes what are the possible ways to do a cart transfer so international checkout can be initiated.

Plug & Play integration

Shopify, Bigcommerce, Magento - those are platforms that Glopal offers plugins for. This fast and easy integration supports a cart transfer by default and you donโ€™t have to do any bespoke development.

If for any reason, there is a failure in the data from merchant cart to Glopal checkout, the customer will be redirected to the merchant's domestic checkout to complete their order.

Checkout API

If your platform is not among the listed platforms supported through the plugin, Glopal offers an easy-to-use Checkout API that you can use to transfer the buyerโ€™s cart and redirect the buyer to the Glopal Checkout.

Integration with Glopal Checkout API should happen on the server-side. In the checkout funnel, you can decide the appropriate step when a buyer should be redirected to the Glopal Checkout to complete the purchase. Checkout API expects to receive information about the buyer's cart content and a checkout experience (country, language, currency) to be presented. In the successful response, API returns URL to redirect buyer into Glopal Checkout.

Glopal will share with you a secret API key for authentication.

{
  "short_name": "mystore",
  "cart": {
    "currency": "USD"
  },
  "visitor": {
    "destination": "FR"
  },
  "items": [
    {
      "id": "5VBHU31KX1S0",
      "name": "Women Chevron Printed Trumpet Hem Dress",
      "quantity": 1,
      "regular_price": 25
    }
  ]
}

If the total cost calculation feature is activated, duties and taxes will be calculated and charged on top of the items (and shipping method price). Note that total cost calculation may require additional data attributes or pre-existing integration/setup.

{
  "short_name": "mystore",
  "cart": {
    "currency": "EUR",
    "prices": {
      "model": "fixed",
      "include_destination_tax": true,
      "include_destination_duties": true
    }
  },
  "visitor": {
    "destination": "FR"
  },
  "items": [
    {
      "id": "5VBHU31KX1S0",
      "name": "Women Chevron Printed Trumpet Hem Dress",
      "quantity": 1,
      "regular_price": 30
    }
  ]
}

If the total cost calculation feature is activated, duties and taxes on the item will be calculated but absorbed into the given price. Duties and taxes on the shipping method will be calculated separately. Note that total cost calculation may require additional data attributes or pre-existing integration/setup.

Additional item attributes can be passed in the attributes object:

{
  "short_name": "mystore",
  "cart": {
    "currency": "USD"
  },
  "visitor": {
    "destination": "FR"
  },
  "items": [
    {
      "id": "5VBHU31KX1S0",
      "name": "Women Chevron Printed Trumpet Hem Dress",
      "quantity": 1,
      "regular_price": 25,
      "attributes": {
        "hs_code": "620444",
        "country_of_origin": "IN",
        "brand": "Placeholder Couture"
      }
    }
  ]
}

Glopal Checkout is presented on a different domain. In order to maintain analytics & tracking, it is possible to pass analytics session identifiers and tracking cookies collected previously on the ecommerce site. This example is showing Google Analytics tracking and Google Ads conversion linker integration.

{
  ...
  "tracking": {
    "cookies": {
      "_gcl_au": "..."
    },
    "client_ids": {
      "ga": "1234.9876"
    }
  }
}

In addition, tracking code & properties should be configured in the Glopal Checkout settings.

The latest API version is 1.3.0

Custom development

If the above options are unsuitable for your needs, you can expose the cart content in a machine-readable form so that Glopal will facilitate the cart transfer from the localized site.

Your platform must support a public endpoint that can be fetched in the session scope (passing a set of HTTP cookies) exposing cart information with enough details to allow cart transfer to the international checkout.

Cart content should contain the list of items that have been added to the cart, including:

  • product name

  • SKU

  • price and quantity

  • discount amounts

Glopal will then facilitate mapping the cart response into the Checkout API, as presented above. Please see the Checkout API description for more information on expected fields and values.

The response should be signed for integrity and authentication.

The response may be encrypted for confidentiality unless information included in the response (product, price, cart quantity) is not already public to the visitor and is not confidential.

Checkout will be presented to the visitor in the French language, with USD price converted to EUR and localized in the according to predefined price localization rules.

Checkout will be presented to the visitor in the French language, with the given price presented in EUR in the .

Additional attribute keys include fields like materials, gender or categories. Please refer to the for full descriptions. Depending on your integration passing additional attributes may be required for accurate total cost calculation.

"calculated prices" mode
"fixed prices" mode
OpenAPI specification
43KB
openapi-checkout.yaml
  • Plug & Play integration
  • Checkout API
  • POSTCreate checkout
  • Custom development

Create checkout

post

Accepts cart content, returning checkout 'id' and 'cart_url' where buyer should be redirected to complete the checkout

Authorizations
Body
store_idstringRequiredExample: mystore
short_namestringOptionalDeprecated

Use store_id instead

Example: mystore
itemsall of[] ยท min: 1Required
and
referrerall ofOptional

Link used for return back from the checkout.

Example: https://mystore.com
stringOptionalPattern: ^https?://
checkoutall ofOptional
one ofOptional
or
and
Responses
200
Success response
application/json
400
Errror response
application/json
401
Unauthorized error response
application/json
post
POST /v1/cart/transfer/external HTTP/1.1
Host: api.glopal.com
Authorization: Bearer token
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "store_id": "mystore",
  "cart": {
    "currency": "USD"
  },
  "visitor": {
    "destination": "FR"
  },
  "items": [
    {
      "id": "5VBHU31KX1S0",
      "name": "Women Chevron Printed Trumpet Hem Dress",
      "quantity": 1,
      "regular_price": 25
    }
  ]
}
{
  "status": "ok",
  "id": "908dac6c-c9cd-4f0e-8a16-9916a5176845",
  "cart_url": "https://mystore.glopal.com/fr-FR/api/cart/redirect/0068af0ae088778c94fc992576d8f"
}