Skip to content

List of Corporate Cards

A method for getting the list of corporate cards for an authorized Sber session. The card identifier is used in the Sber payout methods as business_card_id.

URL

Method: GET

  • Production: https://api.baas.kvell.group/v1/sber/corporate-cards
  • Stage: https://api.baas.stage.kvell.group/v1/sber/corporate-cards

Request parameters

Name Type Required Description
session_id string Yes Identifier of the authorized Sber session
page integer No Page number. Defaults to 1.
size integer No Page size. Defaults to 10.

Request example

GET /v1/sber/corporate-cards?session_id=11111111-1111-1111-1111-111111111111&page=1&size=10 HTTP/1.1
Host: api.baas.kvell.group
X-Api-Key: 00000000-0000-0000-0000-000000000000
X-Signature: signature

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

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

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

Response

Response example

{
  "items": [
    {
      "business_card_id": "business-card-id",
      "card_status": "ACTIVE",
      "masked_card_number": "427600******1234",
      "user_is_holder": true,
      "card_expiry_date": "2026-12-31T00:00:00Z"
    }
  ],
  "page": 1,
  "size": 10
}

{
  "errors": [
    {
      "code": 0,
      "message": "Field required",
      "field": "session_id"
    }
  ]
}

Response parameters

Name
 Type Description
items array List of corporate cards
∟business_card_id string Business card identifier, passed in the payout methods as business_card_id. Up to 36 characters.
∟card_status string Card status, e.g. ACTIVE
∟masked_card_number string Masked card number
∟user_is_holder boolean Card holder flag: whether the session user is the card holder
∟card_expiry_date string Card expiration date
page integer Page number from the request
size integer Page size from the request

Error codes are listed in the General section.