> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Centra APIs Used by the Global-e Integration

The Global-e integration with Centra relies on three Centra APIs working together, each responsible for a different stage of the order lifecycle. Before configuring the Global-e plugin (see Plug-In Configuration), it is important to understand which API handles which step, because each one is configured as a separate plugin in your Centra store.

| API                       | Role in the integration                                                                                                                                                                                  | How it is configured in Centra                                                                                                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Checkout API/DTC API      | Used by Global-e to read the shopper's cart (the selection) from Centra before the international checkout begins. This is the entry point of the cross-border flow.                                      | Added as a Checkout API plugin in your Centra store. Global-e calls it using a session token.                                                                                                   |
| Order API                 | Used by Global-e to create the order in Centra once the shopper has paid, and to update the order when the payment is captured. This is the server-to-server channel Global-e uses to write into Centra. | Added as an Order API plugin in your Centra store, configured under Stores Management → Stores → Plugins. Global-e authenticates using the shared secret you generate when creating the plugin. |
| Integration API (GraphQL) | Used by Global-e to confirm the order after payment, and to cancel the order when an order cancellation is initiated.                                                                                    | Enabled by creating a GraphQL Integration API Token under System → API Tokens.                                                                                                                  |

## API Order Lifecycle

The diagram below shows the end-to-end order lifecycle and which Centra API handles each step:

| # | Stage                              | Centra API used by Global-e | What happens                                                                                                                                              |
| - | ---------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | Shopper begins checkout            | Checkout API/DTC API        | Global-e reads the shopper's cart from your Centra store so it can present the international checkout.                                                    |
| 2 | Shopper pays                       | Order API                   | Once payment is authorized, Global-e creates the order in your Centra store. The order is created with status Pending, based on your store configuration. |
| 3 | Payment is captured                | Order API                   | Global-e updates the existing order in Centra with the captured payment.                                                                                  |
| 4 | Order is confirmed                 | Integration API (GraphQL)   | Global-e moves the order from Pending to Confirmed in Centra.                                                                                             |
| 5 | Order is cancelled (if applicable) | Integration API (GraphQL)   | If a cancellation is initiated, Global-e cancels the order in Centra.                                                                                     |

## Webhooks

In addition to the three APIs above, Global-e subscribes to selected Centra webhook events so that changes made on your Centra store (for example, order updates or returns) are pushed to Global-e in near real time.

## What you need to provide

When you begin the integration, you will be asked to:

* Confirm which Checkout API plugin Global-e should use, if your store has more than one. Please contact Global-e to inform us of which version you are using (Checkout API/DTC API).
* Provide the shared secret generated for the Order API plugin (used for server-to-server authentication).
* Provide the GraphQL Integration API Token generated under System → API Tokens.

Step-by-step instructions for creating and configuring each of these are provided in the sections that follow.