Skip to content

Payout Confirmation

A method for updating the payout status after the user confirms the operation in Sber. Used for payouts created by the payout to a card and SBP payout methods.

URL

Method: POST

  • Production: https://api.pay.kvell.group/v1/orders/payout/sber/confirm
  • Stage: https://api.pay.stage.kvell.group/v1/orders/payout/sber/confirm

Request parameters

Name Type Required Description
transaction string Yes Unique transaction number on the merchant's side
session_id string Yes Identifier of the authorized Sber session

Request example

{
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "session_id": "11111111-1111-1111-1111-111111111111"
}

Request headers

Name Type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Signature

The X-Signature signature is formed by concatenating X-Api-Key, transaction, session_id, and secret_key. sha256 is computed from the resulting string:

sha256({X-Api-Key}{transaction}{session_id}{secret_key})

where secret_key is the secret key found in the merchant's shop settings.

Response

Response example

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "completed",
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "amount": 10000,
  "commission": 0,
  "description": "Payout under contract No. 123",
  "additional_data": {
    "auth_code": "123456",
    "rrn": "123456789012"
  },
  "error_code": null,
  "error_message": null,
  "created_at": "2026-07-29T10:00:00"
}

{
  "errors": [
    {
      "code": 20009,
      "message": "Order not found"
    }
  ]
}

{
  "errors": [
    {
      "code": 20098,
      "message": "session_id: Field required"
    }
  ]
}
  • The transaction must be left in processing: a 5xx response does not mean the confirmation failed.
  • The steps to take are described in the Error and timeout handling section.

Response parameters

Name Type Description
id string Payment ID in the system
status string Transaction status
transaction string Unique transaction number on the merchant's side
amount integer Amount in kopecks
commission integer Commission in kopecks
description string Transaction description
additional_data json Additional data (authorization code, RRN)
error_code string Error code (if any)
error_message string Error message (if any)
created_at string Transaction creation date

List of statuses

Name Description
new New transaction
processing Transaction is being processed
canceled Transaction rejected
completed Transaction completed

Payout status

If the payout remains in processing status, the final status must be obtained using the transaction status method.

Error codes

Code Description
20001 Invalid api-key
20002 Invalid signature
20009 Order not found
20098 Request field validation error