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

# Global Trade

> Use StableStack to power cross-border supplier payments and settle in local fiat currencies.

## Overview

Global trade businesses — exporters, commodity traders, and international distributors — face high FX costs, slow settlement times, and fragmented banking rails when paying overseas suppliers. StableStack eliminates these friction points by letting you send stablecoin-backed payments that settle directly into a recipient's local bank account.

***

## Core Flow

<Steps>
  <Step title="Onboard your suppliers as customers">
    Register each supplier (individual or business) as a customer in StableStack. This creates a managed profile you can attach wallets and payout methods to.

    ```http theme={null}
    POST /business-customers
    ```

    ```json theme={null}
    {
      "business_name": "Lagos Export Co.",
      "email": "finance@lagosexport.com",
      "country": "Nigeria",
      "phone": "+2348012345678"
    }
    ```
  </Step>

  <Step title="Create a stablecoin wallet for the customer">
    Provision a USDC wallet for the supplier. This wallet acts as the staging point for funds before they are withdrawn to fiat.

    ```http theme={null}
    POST /wallets
    ```

    ```json theme={null}
    {
      "customer_id": "CUSTOMER_ID",
      "currency": "USDC",
      "network": "erc20",
      "description": "Supplier settlement wallet"
    }
    ```
  </Step>

  <Step title="Add the supplier's bank account as a payout method">
    Save the supplier's local bank details so payouts can be reused without re-entering account information each time.

    ```http theme={null}
    POST /payout/methods/banks
    ```

    ```json theme={null}
    {
      "customer_id": "CUSTOMER_ID",
      "account_number": "0123456789",
      "bank_code": "000004",
      "bank_name": "United Bank for Africa",
      "currency": "NGN",
      "country": "Nigeria",
      "recipient_name": "Lagos Export Co."
    }
    ```
  </Step>

  <Step title="Check fees before initiating a payout">
    Fetch the current fee for a fiat payout so you can display costs transparently or build them into your pricing.

    ```http theme={null}
    GET /payouts/fees?currency_type=FIAT&currency=USDC&recipient_currency=NGN&amount=5000
    ```
  </Step>

  <Step title="Pay the supplier — stablecoin to local bank">
    Initiate a bank withdrawal. StableStack converts the stablecoin to the recipient's local currency and delivers it via local banking rails.

    ```http theme={null}
    POST /payouts/banks
    ```

    ```json theme={null}
    {
      "customer_id": "CUSTOMER_ID",
      "currency": "USDC",
      "account_number": "0123456789",
      "bank_name": "United Bank for Africa",
      "bank_code": "000004",
      "amount": "5000",
      "recipient_name": "Lagos Export Co.",
      "recipient_currency": "NGN",
      "recipient_country": "Nigeria"
    }
    ```
  </Step>

  <Step title="Track the payment">
    Monitor the payout status via the transactions API or listen for real-time webhook events.

    ```http theme={null}
    GET /customers/transactions/by_ref_id/{reference_id}
    ```

    **Relevant webhook events:**

    * `payout.initiated`
    * `payout.processing`
    * `payout.completed`
    * `payout.failed`
  </Step>
</Steps>

***

## Supported Corridors

StableStack supports payout to the following fiat currencies relevant to global trade:

| Region        | Currency | Payout |
| ------------- | :------: | :----: |
| Nigeria       |    NGN   |    ✅   |
| South Africa  |    ZAR   |    ✅   |
| United States |    USD   |    ✅   |
| Europe        |    EUR   |    ✅   |
| Ghana         |    GHS   |   Q3   |
| Kenya         |    KES   |   Q4   |
| UAE           |    AED   |   Q4   |

***

## Key APIs Used

| Endpoint                                               | Purpose                    |
| ------------------------------------------------------ | -------------------------- |
| `POST /business-customers`                             | Register a supplier        |
| `POST /wallets`                                        | Create a stablecoin wallet |
| `POST /payout/methods/banks`                           | Save a bank payout method  |
| `GET /payouts/fees`                                    | Fetch fees before sending  |
| `POST /payouts/banks`                                  | Initiate a bank payout     |
| `GET /customers/transactions/by_ref_id/{reference_id}` | Track transaction status   |

***

## Next Steps

* [Authentication](/authentication) — Get your API key
* [Webhook Events](/webhooks/events) — Set up real-time payout notifications
* [Supported Currencies](/coverage/currencies) — Full list of supported corridors