Skip to content

Payout Confirmation

Confirming an SBP payout with an OTP code.

If the shop has the payout confirmation via OTP code option enabled, you must call this method. Contact your manager for details.

URL

Method: POST

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

Request parameters

Name
 Data type Required Description
transaction string Yes Unique transaction number on the merchant's side
otp string Yes OTP code (one-time password)

Example request

{
  "transaction": "string",
  "otp": "string"
}

Request headers

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

Building the signature

The request must be signed with an electronic signature. The RSA/SHA256 algorithm is used. This value must be passed in the X-Signature HTTP request header. The signature generation algorithm is the same as when making a payout.

Response

Example response

{
  "id": "string",
  "status": "string",
  "transaction": "string",
  "amount": 0,
  "commission": 0,
  "description": "string",
  "created_at": "string"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}
  • If a 5XX response is received, the transaction must be left in processing and a request sent to the transaction status method.
  • These errors can occur for various reasons: on the network interaction side, or due to technical failures of the server or software.
  • If this problem recurs, it's recommended to contact support.

Response parameters

Name Data type Description
amount integer Amount in kopecks
status string Transaction status
id string Payment ID in the system
description string Transaction description
transaction string Unique transaction number on the merchant's side
created_at string Transaction creation date
commission integer Commission in kopecks