Changelog

Changes to the KVELL API and documentation are published here.

2026-09-11

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

New. Added an overview of nominal accounts: choosing between Sber and Alfa-Bank methods.
New. Added methods for payouts via SBP with conversion into the shop's currency: payout feasibility check and making a payout.

New. Added the payout to a bank account via Alfa-Bank nominal account method: a transfer to the recipient's bank account by name or full name, INN, account number, and bank BIC. The recipient can be an individual, a sole proprietor, or a legal entity.

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.

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.

New. Added a description of the method for obtaining the public key for the cryptogram: the card data cryptogram format, key caching rules, and its rotation.

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.

Changed. Reworked the description of making a payout to a card.
Changed. Reworked the description of confirming a card payout via OTP.
Changed. Reworked the description of making a payout via SBP.
Changed. Signature generation for card and SBP payouts was moved into a shared section and supplemented with examples.
Changed. Expanded the description of SBP payout feasibility check status: added errors received from banks and NSPK, status-processing logic, and the recipient's account mask.
Changed. Clarified the purpose of the list of banks by phone number: the list is built from transfer history and is for reference only.

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.