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

# Stablecoin Corridor: USDC to Local Fiat for B2B Payouts

> Send USDC and settle in local fiat for B2B payouts to suppliers, contractors, and payroll across Brazil, Mexico, Nigeria, Kenya, and South Africa.

The Stablecoin Corridor lets you move USDC onto local fiat rails so you can pay suppliers, contractors, and payroll recipients in their own currency—without touching correspondent banking. You hold USDC, submit a payout request, and Circle's Cross-Platform Network (CPN) handles the fiat leg. The entire flow runs through three API calls.

## Supported corridors

Every corridor settles from USDC into a local currency. The table below shows the destinations available today.

| Destination currency | Country      | ISO code |
| -------------------- | ------------ | -------- |
| Brazilian Real       | Brazil       | `BRL`    |
| Mexican Peso         | Mexico       | `MXN`    |
| Nigerian Naira       | Nigeria      | `NGN`    |
| Kenyan Shilling      | Kenya        | `KES`    |
| South African Rand   | South Africa | `ZAR`    |

## Base URL

All Corridor API calls go to the production endpoint below. There is no sandbox subdomain—use your dashboard test credentials for pre-production runs.

| Environment | Base URL                         |
| ----------- | -------------------------------- |
| Production  | `https://corridor.meterlane.app` |

## How it works

The Corridor flow is three steps. You create a corridor once per destination currency, then reuse it for as many payouts as you need.

1. **Create a corridor** — `POST /corridors` registers a new corridor for a given destination currency. The corridor starts in `PENDING_KYC` status and moves to `ACTIVE` after your organization completes KYC verification in the dashboard.
2. **Get a quote** — `GET /corridors/:id/quote` returns a live FX rate, the destination amount after fees, and a `quoteId` that locks the rate for a short window.
3. **Initiate a payout** — `POST /corridors/:id/pay` submits the payout using the locked quote. Circle confirms settlement and posts a webhook event back to Meterlane, which updates the payment status from `PENDING` to `SETTLED`.

## Status lifecycle

A corridor's status follows a fixed path, and a payment's status follows its own.

**Corridor status:**

```text theme={null}
PENDING_KYC → ACTIVE
```

**Payment status:**

```text theme={null}
PENDING → SETTLED
        → FAILED
        → COMPLIANCE_HOLD
```

## Platform fees

Meterlane charges a transaction fee on each payout. The all-in fee, including partner rail costs, is visible in the dashboard quote UI before you confirm.

| Fee type                 | Range         |
| ------------------------ | ------------- |
| Platform transaction fee | 0.25 %–0.65 % |

## Corridor vs Agent Gateway

Corridor and Agent Gateway are separate products with different payment models. Use this table to pick the right one.

|                   | **Stablecoin Corridor**                        | **Agent Gateway**                                     |
| ----------------- | ---------------------------------------------- | ----------------------------------------------------- |
| **Use case**      | B2B payouts to suppliers, payroll, contractors | Monetized API routes, AI-agent micropayments          |
| **Payment model** | FX quote → bank rail settlement                | x402 micropayments (`402` + `X-Payment-Requirements`) |
| **Key endpoints** | `/corridors/:id/quote` + `/corridors/:id/pay`  | `/gateway/{orgSlug}/{routePath}`                      |
| **Settlement**    | Local fiat via Circle CPN                      | USDC on-chain                                         |
| **Recipient**     | Bank account holder                            | Any USDC-capable wallet                               |

## Next steps

<CardGroup cols={2}>
  <Card title="Quote & Pay" icon="circle-dollar-to-slot" href="/corridor/quote-and-pay">
    Step-by-step guide to creating a corridor, fetching a live quote, and submitting your first payout.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/corridor/webhooks">
    Configure Circle webhooks to receive real-time payment status updates in your application.
  </Card>
</CardGroup>