Skip to content

SBP

SBP for legal entities lets you register payment links and generate QR codes on the recipient's request. The recipient can pass them to the payer to make a payment based on the data provided.

Creating a session

Creating a session is used to initialize a payment.

URL

Method: POST

  • Production: https://api.pay.kvell.group/v1/orders/session
  • Stage: https://api.pay.stage.kvell.group/v1/orders/session

Request parameters

Name
 Data type Required Description
amount integer Yes Amount in kopecks
description string Yes Transaction description
transaction string Yes Unique transaction number on the merchant's side
extra_data json field No Additional information
fiscal_data json field No Fiscal data 
{
  "transaction": "57c49ef5-5b15-4b1e-900d-6d85d0a7f7b4",
  "amount": 10000,
  "description": "Item for 100 rubles",
  "extra_data": {
        "merchant_data_key": "merchant_data_value"
    }
}

Request headers

Name Data 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, amount, and secret_key. A sha256 hash is computed from the resulting string:

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

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

Response

{
  "ok": true
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

Registering a payment

The payment registration is performed by the payment recipient to subsequently obtain a QR code (payment link) that the payer will use to make the payment.

URL

Method: POST

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

Request parameters

Name
 Data type Required Description
transaction string Yes Unique transaction number on the merchant's side
tax_percentage string No Tax amount for the SBP operation, in kopecks
customer string No Customer identifier 
{
  "transaction": "57c49ef5-5b15-4b1e-900d-6d85d0a7f7b4",
  "customer": "customer@example.com"
}

Request headers

Name Data 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, and secret_key. A sha256 hash is computed from the resulting string:

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

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

Response

{
  "form_url": "https://redirect.url/to_sbp"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

Upon receiving form_url, redirect the user to that page, or use that link to generate a QR code.