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

# Apply for Issuer Program

> Submit an application to join the Yativo Card Issuer Program

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_ACCESS_TOKEN`
</ParamField>

<ParamField body="funding_structure" type="string" required>
  Funding model for the program.

  | Value           | Description                                                                                                                                                  |
  | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `master_wallet` | You maintain a shared balance and push funds to each customer card via the Fund Customer API. Best for platforms that want centralised control over top-ups. |
  | `non_master`    | Each customer funds their own card wallet independently. Best for self-service crypto-funded cards.                                                          |
</ParamField>

<ParamField body="preferred_chain" type="string">
  The chain your master wallet will receive deposits on. `SOL` (default) or `XDC`. Yativo auto-provisions a wallet for the chosen chain on approval. Most issuers use `SOL`.
</ParamField>

<ParamField body="iban_enabled" type="boolean">
  Whether to enable IBAN functionality for cardholders in your program. Defaults to `false`.
</ParamField>

<Note>
  The Issuer Program requires prior eligibility approval. Check `GET /v1/card-issuer/eligibility` first. If not eligible, contact your account manager or [support@yativo.com](mailto:support@yativo.com).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/apply' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "funding_structure": "master_wallet",
      "preferred_chain": "SOL",
      "iban_enabled": false
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "success": true,
    "message": "Application submitted. An admin will review your request.",
    "data": {
      "id": "69ecc05a4fc8c9c148ed1a9a",
      "status": "pending",
      "funding_structure": "master_wallet",
      "preferred_chain": "SOL",
      "iban_enabled": false
    }
  }
  ```

  ```json 409 Already applied theme={null}
  {
    "success": false,
    "error": "ALREADY_APPLIED",
    "message": "Application already exists with status: pending",
    "data": {
      "status": "pending",
      "applied_at": "2026-04-01T10:00:00.000Z"
    }
  }
  ```

  ```json 403 Not eligible theme={null}
  {
    "success": false,
    "error": "NOT_ELIGIBLE",
    "message": "Your account is not yet eligible for the Card Issuer Program. Contact support to request access."
  }
  ```
</ResponseExample>
