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

# Create one non-instant checkout deposit

> Creates a CS2 or Rust deposit from items in the authenticated checkout inventory. A 202 response means dispatch was accepted but the immediate result was uncertain; retain the returned status capability and reconcile by polling the deposit status endpoint. Do not create a replacement deposit unless the returned state permits it.




## OpenAPI

````yaml /openapi.yaml post /v1/checkout/deposits
openapi: 3.1.0
info:
  title: Skinloop API
  version: 1.1.0-draft
  description: |
    Public contract for Skinloop merchant payments, hosted checkout status,
    merchant dashboard reads, and merchant webhooks. Skinloop never exposes
    credentials, private identifiers, trade URLs, or client tokens.
servers:
  - url: https://api.skinloop.io
    description: Production
security: []
tags:
  - name: Payments
  - name: Checkout
  - name: Reporting
  - name: Dashboard
paths:
  /v1/checkout/deposits:
    post:
      tags:
        - Checkout
      summary: Create one non-instant checkout deposit
      description: >
        Creates a CS2 or Rust deposit from items in the authenticated checkout
        inventory. A 202 response means dispatch was accepted but the immediate
        result was uncertain; retain the returned status capability and
        reconcile by polling the deposit status endpoint. Do not create a
        replacement deposit unless the returned state permits it.
      operationId: createCheckoutDeposit
      parameters:
        - $ref: '#/components/parameters/CheckoutIdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCheckoutDepositRequest'
      responses:
        '200':
          description: Existing deposit returned for an idempotent replay
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutDeposit'
        '201':
          description: Deposit created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutDeposit'
        '202':
          description: Deposit dispatched; status requires reconciliation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutDeposit'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/IdempotencyConflict'
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - checkoutBearer: []
components:
  parameters:
    CheckoutIdempotencyKey:
      name: Idempotency-Key
      in: header
      required: true
      schema:
        type: string
        minLength: 16
        maxLength: 255
        pattern: ^[A-Za-z0-9._~:/-]{16,255}$
  schemas:
    CreateCheckoutDepositRequest:
      type: object
      additionalProperties: false
      required:
        - itemIds
      properties:
        itemIds:
          type: array
          minItems: 1
          maxItems: 250
          uniqueItems: true
          items:
            type: string
            minLength: 1
            maxLength: 200
        game:
          type: string
          enum:
            - cs2
            - rust
    CheckoutDeposit:
      allOf:
        - $ref: '#/components/schemas/CheckoutDepositStatus'
        - type: object
          required:
            - statusToken
      example:
        depositId: dep_0123456789abcdefghijklmnop
        botDisplayName: Skinloop Bot
        botProfileUrl: https://steamcommunity.com/profiles/76561198000000000
        items:
          - id: item_123
            asset_id: '123456789'
            name: Example Item
            market_hash_name: Example Item
            icon_url: https://cdn.example/item.png
            appid: 730
            tradable: true
            exterior: null
            wear: null
            offer:
              accepted: true
              available: true
              price: '49.99'
              price_minor: 4999
        total: '49.99'
        requiredAmount: '49.99'
        overpaymentMinor: 0
        currency: USD
        game: cs2
        state: initiated
        expiresAt: '2026-09-18T12:10:00Z'
        createdAt: '2026-09-18T12:00:00Z'
        updatedAt: '2026-09-18T12:00:00Z'
        pollAfterSeconds: 3
        statusToken: st_0123456789abcdefghijklmnopqrstuvwxyzABCDEFG
        reservationRequired: true
        fulfillmentAllowed: false
        holdUntil: null
        warnings: []
    CheckoutDepositStatus:
      type: object
      description: >
        expiresAt is the checkout offer-acceptance deadline, not a status
        capability expiry. A valid statusToken remains usable after the checkout
        session expires so a protected trade can complete.
      additionalProperties: false
      required:
        - depositId
        - botDisplayName
        - botProfileUrl
        - items
        - total
        - requiredAmount
        - overpaymentMinor
        - currency
        - game
        - state
        - expiresAt
        - createdAt
        - updatedAt
        - pollAfterSeconds
        - reservationRequired
        - fulfillmentAllowed
        - holdUntil
        - warnings
      properties:
        depositId:
          type: string
          pattern: ^dep_[A-Za-z0-9_-]{20,}$
        botDisplayName:
          type:
            - string
            - 'null'
          maxLength: 200
        botProfileUrl:
          type:
            - string
            - 'null'
          pattern: ^https://steamcommunity\.com/profiles/[0-9]{17}$
        items:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/CheckoutInventoryItem'
        total:
          type: string
          pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
        requiredAmount:
          type: string
          pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
        overpaymentMinor:
          type: integer
          minimum: 0
        currency:
          type: string
          const: USD
        game:
          type: string
          enum:
            - cs2
            - rust
        state:
          type: string
          enum:
            - initiated
            - pending
            - active
            - hold
            - completed
            - canceled
            - declined
            - failed
            - reverted
            - expired
            - reconciliation_required
        expiresAt:
          type: string
          format: date-time
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        pollAfterSeconds:
          type: integer
          minimum: 1
        statusToken:
          type: string
          pattern: ^st_[A-Za-z0-9_-]{43}$
          description: Returned on deposit creation and required for later status reads.
        reservationRequired:
          type: boolean
        fulfillmentAllowed:
          type: boolean
        holdUntil:
          type:
            - string
            - 'null'
          format: date-time
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/MerchantWarning'
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
    CheckoutInventoryItem:
      type: object
      additionalProperties: false
      required:
        - id
        - asset_id
        - name
        - market_hash_name
        - icon_url
        - appid
        - tradable
        - offer
      properties:
        id:
          type: string
        asset_id:
          type: string
        name:
          type: string
        market_hash_name:
          type: string
        icon_url:
          type:
            - string
            - 'null'
          format: uri
        appid:
          type: integer
          enum:
            - 730
            - 252490
        tradable:
          type: boolean
          const: true
        exterior:
          type:
            - string
            - 'null'
        wear:
          type:
            - string
            - 'null'
        offer:
          type: object
          additionalProperties: false
          required:
            - accepted
            - available
            - price
            - price_minor
          properties:
            accepted:
              type: boolean
              const: true
            available:
              type: boolean
              const: true
            price:
              type: string
              pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
            price_minor:
              type: integer
              minimum: 1
    MerchantWarning:
      type: object
      additionalProperties: false
      required:
        - code
        - severity
        - message
        - action
      properties:
        code:
          type: string
          enum:
            - checkout_expiring
            - selected_value_above_target
            - trade_pending
            - trade_hold_pending
            - reconciliation_required
        severity:
          type: string
          enum:
            - info
            - warning
            - action_required
        message:
          type: string
        action:
          type: string
        documentationUrl:
          type: string
          format: uri
        details:
          type: object
          additionalProperties:
            oneOf:
              - type: string
              - type: number
  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication or signature verification failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Checkout origin is not allowed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    IdempotencyConflict:
      description: Idempotency key was previously used with a different request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PayloadTooLarge:
      description: Checkout request body exceeds 16 KiB
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limit exceeded
      headers:
        Retry-After:
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServiceUnavailable:
      description: Checkout service is not configured or unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    checkoutBearer:
      type: http
      scheme: bearer
      bearerFormat: opaque checkout session or deposit status capability
      description: >
        Checkout creation uses the opaque ten-minute session token. Deposit
        status reads use the deposit-specific statusToken returned only by a
        successful deposit POST.

````