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

# Start Crypto.com payment

> Create a Crypto.com payment and return the payment payload (URL and optional QR code)



## OpenAPI

````yaml post /sdk/{environmentId}/onramps/cryptoDotCom/payment
openapi: 3.0.1
info:
  title: Dashboard API
  description: Dashboard API documentation
  version: 1.0.0
servers:
  - url: https://app.dynamicauth.com/api/v0
  - url: https://app.dynamic.xyz/api/v0
  - url: http://localhost:3333/api/v0
security: []
tags:
  - name: Analytics
  - name: SDK
  - name: Organizations
  - name: Projects
  - name: Environments
  - name: Users
  - name: Invites
  - name: Tokens
  - name: Origins
  - name: Allowlists
  - name: Wallets
  - name: Members
  - name: Sessions
  - name: Settings
  - name: Gates
  - name: Chains
  - name: Exports
  - name: Events
  - name: Webhooks
  - name: Custom Fields
  - name: OrganizationMfaSettings
  - name: CustomHostnames
  - name: TestAccount
  - name: NameServices
  - name: GlobalWallets
  - name: GlobalWalletConnections
  - name: UserApiTokens
  - name: Waas
  - name: WalletConnect
paths:
  /sdk/{environmentId}/onramps/cryptoDotCom/payment:
    post:
      tags:
        - SDK
      summary: Start Crypto.com payment
      description: >-
        Create a Crypto.com payment and return the payment payload (URL and
        optional QR code)
      operationId: createCryptoDotComPayment
      parameters:
        - $ref: '#/components/parameters/environmentId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CryptoDotComPaymentCreateRequest'
      responses:
        '200':
          description: Crypto.com payment payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CryptoDotComPaymentResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          description: Not found
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - bearerAuth: []
components:
  parameters:
    environmentId:
      in: path
      name: environmentId
      required: true
      description: ID of the environment
      schema:
        $ref: '#/components/schemas/uuid'
  schemas:
    CryptoDotComPaymentCreateRequest:
      type: object
      required:
        - amount
        - currency
        - walletAddress
        - chain
      properties:
        amount:
          type: number
          description: >-
            A positive integer representing how much to collect in the smallest
            currency unit (e.g., 100 cents to collect $1.00). Refer to [Pricing
            Currencies](https://pay-docs.crypto.com/#api-reference-resources-payments-pricing-currencies)
            for the smallest unit for each currency.
          example: 100
        currency:
          type: string
          description: >-
            Three-letter currency code for the payment amount (pricing
            currency). Must be a supported fiat currency / cryptocurrency. Refer
            to [Pricing
            Currencies](https://pay-docs.crypto.com/#api-reference-resources-payments-pricing-currencies)
            for the currency code.
          example: USD
        description:
          $ref: '#/components/schemas/NonEmptyStringWith255MaxLength'
        metadata:
          type: object
          description: >-
            Set of key-value pairs that you can attach to an object. This can be
            useful for storing additional information about the object in a
            structured format.
        orderId:
          $ref: '#/components/schemas/NonEmptyStringWith50MaxLength'
        subMerchantId:
          $ref: '#/components/schemas/NonEmptyStringWith255MaxLength'
        walletAddress:
          $ref: '#/components/schemas/WalletPublicKey'
        networkId:
          $ref: '#/components/schemas/NonEmptyStringWith50MaxLength'
        chain:
          $ref: '#/components/schemas/ChainEnum'
        merchantName:
          $ref: '#/components/schemas/NonEmptyStringWith255MaxLength'
    CryptoDotComPaymentResponse:
      type: object
      required:
        - id
        - amount
        - currency
        - paymentUrl
        - qrCode
        - status
      properties:
        id:
          $ref: '#/components/schemas/uuid'
        amount:
          type: number
          description: >-
            A positive integer representing how much to collect in the smallest
            currency unit (e.g., 100 cents to collect $1.00). Refer to [Pricing
            Currencies](https://pay-docs.crypto.com/#api-reference-resources-payments-pricing-currencies)
            for the smallest unit for each currency.
          example: 2500
        currency:
          type: string
          description: >-
            Three-letter currency code for the payment amount (pricing
            currency). Must be a supported fiat currency / cryptocurrency. Refer
            to [Pricing
            Currencies](https://pay-docs.crypto.com/#api-reference-resources-payments-pricing-currencies)
            for the currency code.
          example: USD
        amountRefunded:
          type: number
          description: >-
            Amount in cents refunded (can be less than the amount of the payment
            if a partial refund was issued).
          example: 0
        created:
          type: number
          description: >-
            Time at which the object was created. Measured in seconds since the
            Unix epoch.
          example: 1555098161
        cryptoCurrency:
          type: string
          description: The cryptocurrency to be collected for this payment.
        cryptoAmount:
          type: string
          description: The amount of cryptocurrency to be collected for this payment.
          example: '1894.8'
        customerId:
          type: string
          description: >-
            ID of the customer created in Crypto.com Pay Merchant Dashboard, if
            exists.
          example: '1234567890'
        paymentUrl:
          type: string
          description: >-
            The URL of the payment page that customers will navigate to in order
            to make the payment.
          example: >-
            https://js.crypto.com/sdk/payments/checkout/set_wallet?publishableKey=XXX&sdkMeta=YYY
        qrCode:
          type: string
        returnUrl:
          type: string
          description: >-
            The URL for payment page to redirect back to when the payment
            becomes succeeded.
          example: http://YOUR_WEBSITE.com/orders/123/complete
        cancelUrl:
          type: string
          description: >-
            The URL for payment page to redirect to when the payment is failed
            or cancelled.
          example: http://YOUR_WEBSITE.com/orders/123/fail
        description:
          type: string
          description: An arbitrary string attached to the object.
          example: Crypto.com Tee (Unisex)
        liveMode:
          type: boolean
          description: >-
            Has the value true if the object exists in live mode or the value
            false if the object exists in test mode.
          example: false
        metadata:
          type: object
          description: >-
            Set of key-value pairs that you can attach to an object. This can be
            useful for storing additional information about the object in a
            structured format.
        orderId:
          type: string
          description: >-
            Merchant provided order ID for this payment. Merchants can view the
            associated order ID of each payment on the Merchant Dashboard.
            Crypto.com Pay does not verify or guarantee the uniqueness of the
            values in this field.
          example: 640cf83d-a316-4030-9878-71be1d98b737
        recipient:
          type: string
          description: The name of the merchant collecting this payment.
          example: Crypto.com Shop
        refunded:
          type: boolean
          description: >-
            Whether the charge has been fully refunded. If the charge is only
            partially refunded, this attribute will still be false.
          example: false
        status:
          type: string
          description: >-
            The status of the payment is either pending (pending payment),
            succeeded (payment captured), or cancelled.
          example: pending
        expiredAt:
          type: number
          description: >-
            Time at which the payment expires. Measured in seconds since the
            Unix epoch.
          example: 1555098461
    uuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      minLength: 36
      maxLength: 36
      example: 95b11417-f18f-457f-8804-68e361f9164f
    NonEmptyStringWith255MaxLength:
      type: string
      pattern: ^(?=\S)[\p{L}\p{N}a-zA-Z _.,:!?&%@\/+\-'|]+(?<=\S)$
      maxLength: 255
      example: An example name
    NonEmptyStringWith50MaxLength:
      type: string
      pattern: ^(?=\S)[\p{L}\p{N}a-zA-Z _.,:!?&%@\/+\-'|]+(?<=\S)$
      example: An example name
      maxLength: 50
    WalletPublicKey:
      type: string
      pattern: ^[A-Za-z0-9]{18,100}$
      description: >-
        Valid blockchain wallet address, must be an alphanumeric string without
        any special characters
      example: '0xbF394748301603f18d953C90F0b087CBEC0E1834'
      maxLength: 255
    ChainEnum:
      type: string
      enum:
        - ETH
        - EVM
        - FLOW
        - SOL
        - ALGO
        - STARK
        - COSMOS
        - BTC
        - ECLIPSE
        - SUI
        - SPARK
        - TRON
        - APTOS
        - TON
        - STELLAR
    BadRequest:
      type: object
      properties:
        error:
          type: string
    InternalServerError:
      type: object
      properties:
        error:
          type: string
          example: Internal Server Error
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BadRequest'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InternalServerError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````