Skip to content

Changelog

Changes to the KVELL API and documentation are published here.

2026-10-23

Payments

  • Changed. The payment refund response now includes the operation field — the refund operation with its own status new, success, or declined. If the bank does not confirm the refund immediately, the payment status does not change, and the refund result has to be tracked by the operation — see «Delayed refund».

Transactions

  • New. Retrieving transaction status now accepts the optional with_operations query parameter: with true, the response includes the operations array with refunds, reversals, and authorization confirmations and their results, including those declined by the bank.

2026-10-02

Customers

  • Changed. The card by transaction response now includes bank_id, bank_name, and bank_url — the card issuing bank details.

2026-09-25

Transactions

  • New. The transaction error codes now include bnpl-rejected, ip-blocked, merchant-configuration-error, refund-amount-exceeds-payment, and rejected-by-merchant. If your integration handles error_code against a list of known values, add the new codes.

2026-09-21

Payments

  • Changed. The preauthorization payment now supports an optional bind_card parameter — linking the card in KVELL after a successful preauthorization. customer_key is required for linking.

Fiscalization

  • New. Fiscalization now supports the agent scheme: a receipt item can carry the agent attribute agent_info (tag 1222) and supplier details supplier_info (tag 1224), so the receipt can name another organisation as the supplier. Both parameters are optional and are supported only by the ATOL Online provider.

2026-09-18

Payments

2026-09-11

Documentation

  • New. The documentation is now available in English.

2026-09-10

Payments

  • New. Added a description of working with the digital ruble: who it affects, acceptance requirements, and how to accept such payments.

Payouts

2026-08-27

Payouts

2026-08-26

Self-employed

  • New. Cancelling a receipt now has an optional request body with a reason parameter — you can specify the reason: REGISTRATION_MISTAKE (the receipt was created by mistake) or REFUND (a refund). Without a request body, REGISTRATION_MISTAKE is used; the signature is still generated from receipt_id only.
  • Changed. Cancelling a receipt is now possible not only in the ready status, but also in the await_confirm status — when the receipt is registered and awaiting income confirmation from the self-employed individual.
  • Changed. The await_confirm status has been added to the description of receipt statuses in the receipt creation and receipt retrieval methods.
  • Changed. Error 35 has been added to the BAAS API error reference — a receipt in the await_confirm status cannot be cancelled yet; the request must be retried later.

2026-08-24

Self-employed

  • Changed. The act_id parameter — the identifier of the act the receipt is linked to — has been added to the response of the receipt creation and receipt retrieval methods.

2026-08-20

Cryptogram

2026-08-11

Payouts

2026-08-10

Payments

  • New. Added a description of card payment via H2H without using the KVELL payment page, including PCI DSS requirements.
  • Changed. Reworked the description of creating a payment session.
  • Changed. Expanded the description of payment via SBP: added the integration scenario, described response variants, and account-binding specifics.

Payouts

Transactions

  • Changed. Reworked the description of the transaction list retrieval method: clarified parameters, response formats, and error handling.
  • Changed. Expanded the description of transaction status, including operation statuses and bank decline reasons.

Documentation