> For the complete documentation index, see [llms.txt](https://docs.zebec.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zebec.io/developer-docs/partner-api.md).

# Partner API

Zebec Partner API v1 — top up existing Carbon cards on behalf of your users.

The **Zebec Partner API (v1)** is a B2B surface for partners integrating existing Carbon card top-ups and end-user 2FA on behalf of their users.

**Base URLs**

* Sandbox: `https://dev-super.api.zebec.io/`
* PROD: `https://api.superapp.zebec.io`

**Sandbox Swagger UI:** <https://dev-super.api.zebec.io/api/partner>

Production uses the same routes and schema at the production base URL. The production Swagger UI is not publicly exposed; request the versioned OpenAPI document from your Zebec partner engineer when production schema validation is required.

## What you can do

* Send and verify OTPs for end users under your partner.
* Read Carbon card metadata and transaction history.
* Discover top-up programs, build quotes, and submit signed top-ups.

## Supported chains

Top-up availability is partner-specific. Use `GET /partner/v1/topup/programs` as the source of truth for the accepted tokens and pass the returned `sourceTokenMint` to the quote endpoint.

| Chain           | `sourceChain` | Notes                                                                                                                          |
| --------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Solana          | `SOLANA`      | Solana card tokens.                                                                                                            |
| Ethereum        | `ETHEREUM`    | EVM top-ups.                                                                                                                   |
| Base            | `BASE`        | EVM top-ups.                                                                                                                   |
| BNB Smart Chain | `BINANCE`     | EVM top-ups.                                                                                                                   |
| Polygon         | `POLYGON`     | EVM top-ups.                                                                                                                   |
| Zano            | `ZANO`        | The current card token is FUSD with four decimal places. Use the token address and decimals returned by the programs endpoint. |
| Canton          | `CANTON`      | Canton top-ups use the Canton signature scheme.                                                                                |

Availability is partner-specific. Do not hardcode a chain, token address, or token precision; use the accepted tokens returned by the programs endpoint for the authenticated partner.

## Endpoint summary

| Method | Path                             | Purpose                                                    |
| ------ | -------------------------------- | ---------------------------------------------------------- |
| POST   | `/partner/v1/auth/otp/send`      | Send an OTP to a user email                                |
| POST   | `/partner/v1/auth/otp/verify`    | Verify OTP and get a delegation token                      |
| POST   | `/partner/v1/auth/token/refresh` | Refresh an unexpired delegation token                      |
| GET    | `/partner/v1/cards`              | Get card metadata (no PAN/CVV)                             |
| GET    | `/partner/v1/cards/transactions` | List card transactions                                     |
| GET    | `/partner/v1/topup/programs`     | Discover available Carbon programs, currencies, and tokens |
| GET    | `/partner/v1/topup/quote`        | Build a top-up quote (2-minute TTL)                        |
| POST   | `/partner/v1/topup/preflight`    | Run preflight checks against a live quote                  |
| POST   | `/partner/v1/topup`              | Submit a signed top-up against a quote                     |
| GET    | `/partner/v1/topup/{orderId}`    | Poll top-up status                                         |

## Guides

* [Authentication](/developer-docs/partner-api/authentication.md)
* [Cards](/developer-docs/partner-api/cards.md)
* [Top-up flow](/developer-docs/partner-api/topup-flow.md)

## Getting access

Partner API credentials are issued by Zebec admin. Contact your Zebec partner engineer or <support@zebec.io> to request access.