Nominal accounts
A nominal account in KVELL is used for settlements with recipients: payouts can be made to bank details, to a card, or via SBP. The available methods and API endpoints depend on the nominal account's bank.
In the KVELL service model, KVELL is the owner of the nominal account, and the merchant is the beneficiary. The merchant sends a payout order via the API and receives the operation result. A product description and connection request are available on the KVELL website.
Choose the nominal account's bank
Shared methods for Alfa-Bank
When working with an Alfa-Bank nominal account, payouts to a card and via SBP are performed through the shared methods described in the "Payouts" section. They are also used in other KVELL scenarios.
Payout scenario
| Step | Merchant action |
|---|---|
| Prepare the payout | Collect the recipient's data according to the schema of the chosen method and generate a unique transaction. |
| Send the request | Sign the request body and call the payout API method. Save transaction to check the original operation. |
| Get the result | Follow the scenario for the chosen method: check the transaction status and process the callback, if configured. The HTTP code alone does not confirm a successful payout. |
If the payout creation result is unknown
On a 5XX, timeout, or connection break, the payout may have been created. Check the
original transaction using the same transaction and don't create a
duplicate with a new identifier until the result is established. If a technical error occurs
while requesting the status, safely retry the same status request: such an error does not
determine the payout result.
Questions and answers
How do Sber nominal payouts differ from the «Sber API» section?
This section describes payouts from a Sber nominal account. The «Sber API» section describes a separate payout scenario from a corporate card within an authorized Sber user session. Choose the documentation for your scenario.
Where can I see errors?
Start with the response section of the chosen API method. Common HTTP errors are described in the HTTP error reference, and bank transaction result codes are described in the transaction error code reference.