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

# Initiate a crypto repayment

> Initiates a crypto repayment for a credit transfer.

The requested amount is capped at the outstanding balance. If the minimum of the requested amount and outstanding balance is zero, the request will be rejected with HTTP 400.

**Note:** This endpoint is only available for Line of Credit products. Crypto repayment is not supported for Settlement Advance products.




## OpenAPI

````yaml openapi/credit.yaml post /v1/credit/cryptoRepayment
openapi: 3.0.2
info:
  version: ${version}
  title: Credit API
  description: >
    The Circle Credit API provides access to credit facilities including Line of
    Credit and Settlement Advance products.


    **Line of Credit** enables direct drawdowns with auto-approval and
    asynchronous disbursement. Supports both fiat and crypto repayment.


    **Settlement Advance** requires a reserve-then-request flow with manual
    approval. Requires wire proof upload for disbursement approval. Supports
    fiat repayment only.
servers:
  - url: https://api-sandbox.circle.com
  - url: https://api.circle.com
security: []
tags:
  - name: Credit
    description: Get credit line details.
  - name: Credit Transfers
    description: Create, reserve, and manage credit transfers (drawdowns).
  - name: Credit Fees
    description: View fees charged on credit transfers.
  - name: Credit Repayments
    description: View and initiate repayments on credit transfers.
paths:
  /v1/credit/cryptoRepayment:
    post:
      tags:
        - Credit Repayments
      summary: Initiate a crypto repayment
      description: >
        Initiates a crypto repayment for a credit transfer.


        The requested amount is capped at the outstanding balance. If the
        minimum of the requested amount and outstanding balance is zero, the
        request will be rejected with HTTP 400.


        **Note:** This endpoint is only available for Line of Credit products.
        Crypto repayment is not supported for Settlement Advance products.
      operationId: createCreditCryptoRepayment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreditCryptoRepaymentCreationRequest'
            example:
              idempotencyKey: ba943ff1-ca16-49b2-ba55-1057e70ca5c7
              amount:
                amount: '25000.00'
                currency: USD
      responses:
        '201':
          description: Successfully initiated a crypto repayment.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                title: CreateCreditCryptoRepaymentResponse
                properties:
                  data:
                    $ref: '#/components/schemas/CreditCryptoRepayment'
              example:
                data:
                  id: e5f6a7b8-9012-3456-efab-345678901234
                  amount:
                    amount: '25000.00'
                    currency: USD
                  status: pending
                  createDate: '2024-03-25T10:00:00.000Z'
                  updateDate: '2024-03-25T10:00:00.000Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/NotAuthorized'
        '409':
          $ref: '#/components/responses/Conflict'
      security:
        - bearerAuth: []
components:
  schemas:
    CreditCryptoRepaymentCreationRequest:
      type: object
      description: Request body for initiating a crypto repayment on a credit transfer.
      required:
        - idempotencyKey
        - amount
      properties:
        idempotencyKey:
          $ref: '#/components/schemas/IdempotencyKey'
        amount:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: >-
            The amount and currency to repay. Currency must match the credit
            line currency. The requested amount is capped at the outstanding
            balance.
    CreditCryptoRepayment:
      type: object
      description: A crypto repayment initiated on a credit transfer.
      required:
        - id
        - amount
        - status
        - createDate
        - updateDate
      properties:
        id:
          description: Unique identifier of the crypto repayment.
          type: string
          format: uuid
          example: b3d9d2d5-4c12-4946-a09d-953e82fae2b0
        amount:
          $ref: '#/components/schemas/FiatMoneyUsd'
          description: The repayment amount.
        status:
          description: Current status of the crypto repayment.
          type: string
          enum:
            - pending
          example: pending
        createDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: ISO-8601 UTC date/time when the crypto repayment was created.
        updateDate:
          $ref: '#/components/schemas/UtcTimestamp'
          description: ISO-8601 UTC date/time when the crypto repayment was last updated.
    IdempotencyKey:
      type: string
      description: >-
        Universally unique identifier (UUID v4) idempotency key. This key is
        utilized to ensure exactly-once execution of mutating requests.
      format: uuid
      example: ba943ff1-ca16-49b2-ba55-1057e70ca5c7
    FiatMoneyUsd:
      type: object
      required:
        - amount
        - currency
      properties:
        amount:
          description: Magnitude of the amount, in units of the currency, with a `.`.
          type: string
          example: '3.14'
        currency:
          description: Currency code.
          type: string
          enum:
            - USD
    UtcTimestamp:
      type: string
      description: ISO-8601 UTC date/time format.
      example: '2020-04-10T02:13:30.000Z'
  headers:
    XRequestId:
      description: >-
        Universally unique identifier (UUID v4) for the request. Helpful for
        identifying a request when communicating with Circle support.
      schema:
        type: string
        format: uuid
        example: 2adba88e-9d63-44bc-b975-9b6ae3440dde
  responses:
    BadRequest:
      description: The request cannot be processed due to a client error.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: BadRequest
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 400
              message: Bad request.
          examples:
            response:
              value:
                code: 400
                message: Bad request.
    NotAuthorized:
      description: >-
        The request has not been applied because it lacks valid authentication
        credentials.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: NotAuthorized
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 401
              message: Malformed authorization.
          examples:
            response:
              value:
                code: 401
                message: Malformed authorization.
    Conflict:
      description: >-
        The request has not been applied because it comes in conflict with
        another request (such as re-using an idempotencyKey for a different
        request).
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
      content:
        application/json:
          schema:
            type: object
            title: Conflict
            required:
              - code
              - message
            properties:
              code:
                type: integer
                example: 400
              message:
                type: string
                example: Something went wrong.
            example:
              code: 409
              message: Conflicts with another request.
          examples:
            response:
              value:
                code: 409
                message: Conflicts with another request.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````