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

# Create a Cash App order

> Open a Cash App order and return its payment url.

Opens the order and returns the Cash App payment `url` to send the buyer to.
Poll [Get a Cash App order](/api/cashapp/order) for status once they have paid.


## OpenAPI

````yaml api/openapi.json POST /v1/cashapp
openapi: 3.1.0
info:
  description: Fiat-to-USDC onramp API. The URL prefix (`/v1`) is the version contract.
  license:
    identifier: LicenseRef-Proprietary
    name: Proprietary
  title: Calm API
  version: v1
servers:
  - description: Production
    url: https://api.calmtreasury.xyz
  - description: Sandbox
    url: https://api.sandbox.calmtreasury.xyz
security: []
paths:
  /v1/cashapp:
    post:
      summary: Create a Cash App order
      description: >-
        Opens a Cash App onramp order and returns it, including the Cash App
        payment url. Poll `GET /v1/cashapp/{id}` for status. The order delivers
        to the `wallet` in the body.
      operationId: createCashAppOrder
      requestBody:
        content:
          application/json:
            schema:
              properties:
                amount_usd:
                  pattern: ^\d+(\.\d{1,2})?$
                  type: string
                destination_chain:
                  enum:
                    - 1
                    - 8453
                    - 999
                    - 1337
                    - 4326
                    - 143
                    - 137
                    - 42161
                  type: number
                destination_token:
                  enum:
                    - USDC
                    - USDm
                    - AUSD
                    - USDC.e
                  type: string
                wallet:
                  pattern: ^0x[a-fA-F0-9]{40}$
                  type: string
              required:
                - wallet
                - amount_usd
                - destination_chain
                - destination_token
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  created_at:
                    format: date-time
                    type: string
                  destination:
                    properties:
                      amount:
                        type: string
                      chain:
                        description: >-
                          Chain id. Currently 1, 8453, 999, 1337, 4326, 143,
                          137, 42161 — additive; tolerate unknown values.
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                      decimals:
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                      token:
                        type: string
                      wallet:
                        pattern: ^0x[a-fA-F0-9]{40}$
                        type: string
                    required:
                      - wallet
                      - chain
                      - token
                      - amount
                      - decimals
                    type: object
                  fee:
                    properties:
                      amount:
                        type: string
                      decimals:
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                    required:
                      - amount
                      - decimals
                    type: object
                  id:
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                    type: string
                  source:
                    properties:
                      amount:
                        type: string
                      currency:
                        type: string
                    required:
                      - currency
                      - amount
                    type: object
                  status:
                    enum:
                      - pending
                      - processing
                      - confirming
                      - swapping
                      - bridging
                      - awaiting_approval
                      - delivering
                      - completed
                      - failed
                      - refunding
                      - refunded
                      - unfulfilled
                      - expired
                    type: string
                  url:
                    type: string
                required:
                  - id
                  - status
                  - source
                  - destination
                  - fee
                  - url
                  - created_at
                type: object
          description: The created Cash App order.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Bad Request — `error.code` includes: amount_too_large,
            amount_too_small, invalid_address, price_impact_too_high,
            publishable_key_missing, unsupported_asset, unsupported_chain,
            unsupported_route, validation_error.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Unauthorized — `error.code` includes: invalid_publishable_key.'
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Forbidden — `error.code` includes: origin_not_allowed.'
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Too Many Requests — `error.code` includes: rate_limited.'
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Bad Gateway — an upstream dependency failed; the body carries the
            standard error envelope with a cause-specific `error.code`.
      security:
        - publishableKey: []
components:
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
  securitySchemes:
    publishableKey:
      description: Publishable key identifying the calling app.
      in: header
      name: x-calm-publishable-key
      type: apiKey

````