openapi: 3.1.0
info:
  title: QIWI Payments Partner API
  description: QIWI Payment Protocol REST API for payments, refunds, captures, payouts, SBP QR codes and card verification.
  version: 1.0.0
  x-generated-from: https://developer.qiwi.com/ru/payments/
  x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://api.qiwi.com
  description: QIWI Production API
security:
- bearerAuth: []
tags:
- name: Partner
paths:
  /partner/payin/v1/sites/{siteId}/bills/{billId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: billId
      required: true
      schema:
        type: string
    put:
      summary: Create invoice
      operationId: createInvoice
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenericRequest'
      responses:
        '200':
          description: Invoice created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
    get:
      summary: Get invoice status
      operationId: getInvoice
      responses:
        '200':
          description: Invoice details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/bills/{billId}/payments:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: billId
      required: true
      schema:
        type: string
    get:
      summary: List payments for invoice
      operationId: listInvoicePayments
      responses:
        '200':
          description: Payment list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/payments/{paymentId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: paymentId
      required: true
      schema:
        type: string
    put:
      summary: Create payment
      operationId: createPayment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenericRequest'
      responses:
        '200':
          description: Payment created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
    get:
      summary: Get payment status
      operationId: getPayment
      responses:
        '200':
          description: Payment details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/payments/{paymentId}/complete:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: paymentId
      required: true
      schema:
        type: string
    post:
      summary: Complete 3DS authentication
      operationId: completePayment3DS
      responses:
        '200':
          description: 3DS completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/payments/{paymentId}/captures/{captureId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: paymentId
      required: true
      schema:
        type: string
    - in: path
      name: captureId
      required: true
      schema:
        type: string
    put:
      summary: Confirm payment (capture)
      operationId: capturePayment
      responses:
        '200':
          description: Capture created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
    get:
      summary: Get capture status
      operationId: getCapture
      responses:
        '200':
          description: Capture details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/refunds/{refundId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: refundId
      required: true
      schema:
        type: string
    put:
      summary: Execute refund
      operationId: createRefund
      responses:
        '200':
          description: Refund created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
    get:
      summary: Get refund status
      operationId: getRefund
      responses:
        '200':
          description: Refund details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/refunds:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    get:
      summary: List refunds
      operationId: listRefunds
      responses:
        '200':
          description: Refund list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/refunds/{refundId}/decline:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: refundId
      required: true
      schema:
        type: string
    post:
      summary: Decline refund
      operationId: declineRefund
      responses:
        '200':
          description: Refund declined
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/qr:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    post:
      summary: Generate SBP QR code
      operationId: createQrCode
      responses:
        '200':
          description: QR generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/qr/{qrCodeUid}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: qrCodeUid
      required: true
      schema:
        type: string
    get:
      summary: Get QR code status
      operationId: getQrCode
      responses:
        '200':
          description: QR status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/payments/sbp-token:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    put:
      summary: Pay via SBP token
      operationId: paySbpToken
      responses:
        '200':
          description: Payment via SBP
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/check-card:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    post:
      summary: Check card
      operationId: checkCard
      responses:
        '200':
          description: Card check started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/check-card/{checkId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: checkId
      required: true
      schema:
        type: string
    get:
      summary: Get card check status
      operationId: getCardCheck
      responses:
        '200':
          description: Check details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payin/v1/sites/{siteId}/check-card/{checkId}/complete:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: checkId
      required: true
      schema:
        type: string
    post:
      summary: Complete card verification
      operationId: completeCardCheck
      responses:
        '200':
          description: Verification completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payout/v1/sites/{siteId}/payouts/{payoutId}:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: payoutId
      required: true
      schema:
        type: string
    put:
      summary: Create payout
      operationId: createPayout
      responses:
        '200':
          description: Payout created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
    get:
      summary: Get payout status
      operationId: getPayout
      responses:
        '200':
          description: Payout details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
  /partner/payout/v1/sites/{siteId}/payouts/{payoutId}/complete:
    parameters:
    - in: path
      name: siteId
      required: true
      schema:
        type: string
    - in: path
      name: payoutId
      required: true
      schema:
        type: string
    post:
      summary: Complete payout
      operationId: completePayout
      responses:
        '200':
          description: Payout completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      tags:
      - Partner
components:
  schemas:
    GenericResponse:
      type: object
      additionalProperties: true
    GenericRequest:
      type: object
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer