> This page is for Cash App Pay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

### Schema (`response.body`)

```yaml
openapi: 3.1.0
info:
  title: API
  version: 1.0.0
paths:
  /fee-plan-schema-test:
    get:
      operationId: subpackageFeePlans_get-fee-plan-schema-test
      summary: Get FeePlan Schema Test
      description: Hidden endpoint to document FeePlan schema structure.
      tags:
        - subpackage_feePlans
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/feePlans_GetFeePlanSchemaTestFeePlansResponse
tags:
  - name: subpackage_feePlans
servers:
  - url: https://api.cash.app/network/v1
    description: Production
  - url: https://sandbox.api.cash.app/network/v1
    description: Sandbox
components:
  schemas:
    feePlans_FeeRate:
      type: object
      properties:
        basis_points:
          type: integer
          description: >-
            The variable fee charged for processing the payment expressed as
            1/100th of a percentage.
        fixed_amount:
          type: integer
          description: >-
            The amount charged for processing the payment, in the lowest
            denomination of currency on the payment.
             **Note: The currency for the fee is found on the fee plan.**
      description: >-
        A fee rate contains the components of a fee charged by Cash App to
        partners for a given payment.
      title: FeeRate
    Currency:
      type: string
      enum:
        - USD
      description: >-
        Indicates the country associated with an entity. Values are from the
        [ISO-4217 Alpha-3](https://www.iso.org/iso-4217-currency-codes.html)
        specification.


        Current values:


        - `USD`: United States Dollar
      title: Currency
    feePlans_FeePlanFeeType:
      type: string
      enum:
        - PAYMENT
        - DISPUTE
        - PAYOUT
      description: >-
        The kind of transaction this fee plan prices. A fee plan prices exactly
        one of these, so a rate is only meaningful alongside its `fee_type`.
        `PAYMENT` and `PAYOUT` are charged when the applicable transaction is
        captured, `DISPUTE` is charged when the dispute is opened.
      title: FeePlanFeeType
    Metadata:
      type: object
      additionalProperties:
        type: string
      description: >-
        Freeform key-value pairs of arbitrary data associated with this
        resource.


        Keys and values must be passed as strings and not contain any personally
        identifiable information (PII).


        Min keys: `0`

        Max keys: `50`



        > Note: Nested keys are not supported.
      title: Metadata
    feePlans_FeePlan:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 128
          description: A unique identifier for the fee plan issued by Cash App.
        rate:
          $ref: '#/components/schemas/feePlans_FeeRate'
        currency:
          $ref: '#/components/schemas/Currency'
        status:
          type: string
          description: >-
            The state is used to determine whether or not this fee plan is
            currently in use.

            - `ACTIVE`

            - `DISABLED`
        fee_type:
          $ref: '#/components/schemas/feePlans_FeePlanFeeType'
          description: >-
            The kind of transaction this fee plan prices. A fee plan prices
            exactly one of these, so a rate is only meaningful alongside its
            `fee_type`. `PAYMENT` and `PAYOUT` are charged when the applicable
            transaction is captured, `DISPUTE` is charged when the dispute is
            opened.
        reference_id:
          type: string
          minLength: 1
          maxLength: 1024
        metadata:
          $ref: '#/components/schemas/Metadata'
        description:
          type: string
          minLength: 1
          maxLength: 1024
          description: >-
            A free-form text field that stores information associated with the
            fee plan.
        created_at:
          type: string
          format: date-time
          description: >-
            When this fee plan was created, in [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
        updated_at:
          type: string
          format: date-time
          description: >-
            When this fee plan was last updated, in [RFC
            3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
      required:
        - id
        - rate
        - currency
        - status
        - fee_type
        - created_at
        - updated_at
      description: >-
        The full fee plan that PSPs can use to set the buy rates for specific
        merchants.
      title: FeePlan
    feePlans_GetFeePlanSchemaTestFeePlansResponse:
      type: object
      properties:
        fee_plan:
          $ref: '#/components/schemas/feePlans_FeePlan'
      required:
        - fee_plan
      title: GetFeePlanSchemaTestFeePlansResponse

```

**`Example`**

```json Example
{
  "id": "FEE_kewjsmjt35t8qhzyjeqcst5me",
  "rate": {
    "basis_points": 160,
    "fixed_amount": 20
  },
  "currency": "USD",
  "status": "ACTIVE",
  "fee_type": "PAYMENT",
  "reference_id": "external-id",
  "metadata": {},
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:00:00Z"
}
```