> 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:
  /one-time-payment-action-schema-test:
    get:
      operationId: subpackageSchemas_get-one-time-payment-action-schema-test
      summary: Get OneTimePaymentAction Schema Test
      description: Describes a one-time payment action included in a customer request.
      tags:
        - subpackage_schemas
      parameters:
        - name: X-Region
          in: header
          description: >-
            The IATA airport code from the list of accepted regions that is
            closest to the area your server(s) is operating in.
          required: true
          schema:
            type: string
        - name: X-Signature
          in: header
          description: >-
            An HMAC signature generated using the secret value from the API key
            specified in the `Authorization` header. See [signing
            requests](https://developers.cash.app/docs/partner/technical-documentation/api-fundamentals/requests/signing-requests)
            for more information.
          required: true
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/schemas_get-one-time-payment-action-schema-test_Response_200
tags:
  - name: subpackage_schemas
servers:
  - url: https://api.cash.app/customer-request/v1
    description: Production
  - url: https://sandbox.api.cash.app/customer-request/v1
    description: Sandbox
components:
  schemas:
    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
    OneTimePaymentActionType:
      type: string
      enum:
        - ONE_TIME_PAYMENT
      description: The type of the action (`ONE_TIME_PAYMENT`).
      title: OneTimePaymentActionType
    OneTimePaymentAction:
      type: object
      properties:
        amount:
          type: integer
          minimum: 1
          description: >-
            Amount to charge the customer, in the lowest unit of the associated
            currency.


            Min value: `1`
        currency:
          $ref: '#/components/schemas/Currency'
        scope_id:
          type: string
          minLength: 1
          maxLength: 128
          description: >-
            ID of the client, brand, or merchant that will charge the customer.


            If a client ID is passed, the grant from this action can be used to
            create a payment for any merchant owned by the client.


            If a brand ID is passed, the grant from this action can be used to
            create a payment for any merchant that has a matching brand ID.


            If a merchant ID is passed, the grant from this action can be used
            to create a payment for the merchant with a matching ID.


            Min length: `1`

            Max length: `128`
        type:
          $ref: '#/components/schemas/OneTimePaymentActionType'
          description: The type of the action (`ONE_TIME_PAYMENT`).
      required:
        - scope_id
        - type
      description: >-
        Describes an intent for a client to charge a customer a given amount.


        Note the following restrictions when using this action:


        - If no amount is provided to the action, the payment charged may be
        **any** amount.

        - If `amount` is provided, `currency` must be provided too (and vice
        versa).
      title: OneTimePaymentAction
    schemas_get-one-time-payment-action-schema-test_Response_200:
      type: object
      properties:
        one_time_payment_action:
          $ref: '#/components/schemas/OneTimePaymentAction'
      required:
        - one_time_payment_action
      title: schemas_get-one-time-payment-action-schema-test_Response_200

```

**`Example`**

```json Example
{
  "amount": 2500,
  "currency": "USD",
  "scope_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
  "type": "ONE_TIME_PAYMENT"
}
```