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

# Get Pricing

> Retrieve current Fyatu API pricing and fee schedule — card issuance fees, funding fees, and transaction costs. GET /account/pricing.

## Overview

Retrieve the fees applicable to your business account. The fees returned depend on your app type:

| App Type     | Fee Categories               |
| ------------ | ---------------------------- |
| `collection` | Collection fees, Payout fees |
| `issuing`    | Card fees                    |

## Fee Structure

Each fee in the response includes:

| Field      | Type    | Description                                           |
| ---------- | ------- | ----------------------------------------------------- |
| `code`     | string  | Unique fee identifier                                 |
| `name`     | string  | Human-readable fee name                               |
| `type`     | string  | `FIXED` or `PERCENTAGE`                               |
| `rate`     | number  | Fee amount (USD for FIXED, percentage for PERCENTAGE) |
| `minFee`   | number  | Minimum fee (for percentage-based fees)               |
| `maxFee`   | number  | Maximum fee cap (if applicable)                       |
| `isWaived` | boolean | Whether this fee is currently waived for your account |

## Collection App Fees

| Fee Code         | Description                    |
| ---------------- | ------------------------------ |
| `COLLECTION_FEE` | Fee per collection transaction |
| `PAYOUT_FEE`     | Fee per payout/disbursement    |

## Issuing App Fees

| Fee Code             | Description                       |
| -------------------- | --------------------------------- |
| `CARD_ISSUANCE_FEE`  | One-time fee when creating a card |
| `CARD_FUNDING_FEE`   | Fee when adding funds to a card   |
| `CARD_UNLOADING_FEE` | Fee when withdrawing from a card  |
| `CARD_DELETION_FEE`  | Fee when deleting a card          |
| `CARD_MONTHLY_FEE`   | Monthly maintenance fee           |

## Example Usage

```javascript theme={null}
const response = await fetch('https://api.fyatu.com/api/v3/account/pricing', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`App Type: ${data.appType}`);

data.fees.forEach(fee => {
  if (fee.type === 'FIXED') {
    console.log(`${fee.name}: $${fee.rate}`);
  } else {
    console.log(`${fee.name}: ${fee.rate}%`);
  }
});
```

<Tip>
  Check `isWaived` to determine if a fee is currently waived for your account, often as part of promotional offers or custom pricing arrangements.
</Tip>


## OpenAPI

````yaml v3/openapi.json GET /account/pricing
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths:
  /account/pricing:
    get:
      tags:
        - Account
      summary: Get Pricing
      description: >-
        Retrieve applicable fees for your business based on app type. Collection
        apps see collection/payout fees, issuing apps see card fees.
      operationId: getPricing
      responses:
        '200':
          description: Pricing retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingResponse'
              example:
                success: true
                status: 200
                message: Pricing retrieved successfully
                data:
                  appType: issuing
                  fees:
                    - code: CARD_ISSUANCE_FEE
                      name: Card Issuance Fee
                      type: FIXED
                      rate: 5
                      minFee: null
                      maxFee: null
                      isWaived: false
                    - code: CARD_FUNDING_FEE
                      name: Card Funding Fee
                      type: PERCENTAGE
                      rate: 1.5
                      minFee: 0.5
                      maxFee: null
                      isWaived: false
                meta:
                  requestId: req_abc123def456
                  timestamp: '2026-01-05T10:30:00+00:00'
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - BearerAuth: []
components:
  schemas:
    PricingResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
        data:
          $ref: '#/components/schemas/PricingData'
        meta:
          $ref: '#/components/schemas/Meta'
    PricingData:
      type: object
      properties:
        appType:
          type: string
          enum:
            - collection
            - issuing
        fees:
          type: array
          items:
            $ref: '#/components/schemas/Fee'
    Meta:
      type: object
      properties:
        requestId:
          type: string
          description: Unique request ID for tracking
          example: req_abc123def456
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the response
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 401
        message:
          type: string
          example: Invalid credentials
        error:
          $ref: '#/components/schemas/Error'
        meta:
          $ref: '#/components/schemas/Meta'
    Fee:
      type: object
      properties:
        code:
          type: string
          description: Fee code identifier
        name:
          type: string
          description: Human-readable fee name
        type:
          type: string
          enum:
            - FIXED
            - PERCENTAGE
        rate:
          type: number
          description: Fee rate
        minFee:
          type: number
          nullable: true
        maxFee:
          type: number
          nullable: true
        isWaived:
          type: boolean
    Error:
      type: object
      properties:
        code:
          type: string
          description: Error code for programmatic handling
          example: AUTH_INVALID_CREDENTIALS
        details:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: Validation error details (for VALIDATION_ERROR)
    ValidationError:
      type: object
      properties:
        field:
          type: string
          description: Field that failed validation
          example: appId
        message:
          type: string
          description: Validation error message
          example: AppId is required
  responses:
    Unauthorized:
      description: Authentication required or token invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 401
            message: Unable to identify business
            error:
              code: AUTH_TOKEN_INVALID
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from /auth/token

````