Qiwi Payment Protocol
Protocol for accepting Qiwi payments from wallet, card, and account sources, including payment confirmation, status checks, and reconciliation.
OpenAPI Specification
openapi: 3.1.0
info:
title: QIWI Payments 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: []
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' } } } }
get:
summary: Get invoice status
operationId: getInvoice
responses:
'200': { description: Invoice details, content: { application/json: { schema: { $ref: '#/components/schemas/GenericResponse' } } } }
/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' } } } }
/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' } } } }
get:
summary: Get payment status
operationId: getPayment
responses:
'200': { description: Payment details, content: { application/json: { schema: { $ref: '#/components/schemas/GenericResponse' } } } }
/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' } } } }
/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' } } } }
get:
summary: Get capture status
operationId: getCapture
responses:
'200': { description: Capture details, content: { application/json: { schema: { $ref: '#/components/schemas/GenericResponse' } } } }
/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' } } } }
get:
summary: Get refund status
operationId: getRefund
responses:
'200': { description: Refund details, content: { application/json: { schema: { $ref: '#/components/schemas/GenericResponse' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
/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' } } } }
get:
summary: Get payout status
operationId: getPayout
responses:
'200': { description: Payout details, content: { application/json: { schema: { $ref: '#/components/schemas/GenericResponse' } } } }
/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' } } } }
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
schemas:
GenericRequest:
type: object
additionalProperties: true
GenericResponse:
type: object
additionalProperties: true