Skip to content

Cascading Acquiring

Cascading acquiring integrates the same way as the standard checkout form, except two shops must be used.

URL

Method: GET or POST

  • Production: https://pay.kvell.group/checkout/cascade
  • Stage: https://pay.stage.kvell.group/checkout/cascade

Request parameters

Name
 Type Required Description
api_key_1 string Yes Unique identifier of the first shop
api_key_2 string Yes Unique identifier of the second shop
signature string Yes Signature
amount integer Yes Amount in kopecks
description string Yes Transaction description
transaction string Yes Unique transaction number on the merchant's side
success_url string Yes URL to redirect to on successful completion of the request
fail_url string Yes URL to redirect to on failed completion of the request
phone string No Payer's phone number for card binding
customer_key string No Alternative customer identifier for working with saved cards. Pass only one of phone or customer_key.
extra_data json No Additional information
fiscal_data json No Receipt fiscalization under 54-FZ
split_data array No Payment splitting

Building the signature

The signature is built by concatenating api_key_1, api_key_2, transaction, amount, secret_key_1, and secret_key_2. A sha256 hash is computed from the resulting string:

sha256({api_key_1}{api_key_2}{transaction}{amount}{secret_key_1}{secret_key_2})

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

Request examples

GET request

https://pay.kvell.group/checkout/cascade?api_key_1={api_key}&api_key_2={api_key_2}&signature={signature}&amount={amount}&description={description}&transaction={transaction}&success_url={success_url}&fail_url={fail_url}&phone={phone}&extra_data={extra_data}&fiscal_data={fiscal_data}&split_data={split_data}

https://pay.kvell.group/checkout/cascade?api_key_1=d0aea12e-f94a-47ac-9687-633f3f8167ac&api_key_2=ab64d7ee-cfd6-4f32-98ef-35996bd2815b&amount=10000&description=%D0%9F%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%20%E2%84%961&signature=afc09ed74d83849d44c1f1906b10d20c147bf0eb25da940c020c980b3b44ca38&success_url=http%3A%2F%2Fyoursite.com%2Fsuccess&fail_url=http%3A%2F%2Fyoursite.com%2Ffail&transaction=fbfe9f88-d5c7-4994-aed6-ee8003f4f342&phone=79991234567&extra_data=%7B%22string%22%3A%20%22string%22%7D&fiscal_data=%7B%22items%22%3A%20%5B%7B%22name%22%3A%20%22TEST%22%2C%20%22price%22%3A%2010025%2C%20%22quantity%22%3A%202%2C%20%22sum%22%3A%2020050%2C%20%22measurement_unit%22%3A%20%22%D0%BA%D0%B3%22%2C%20%22payment_method%22%3A%20%22full_payment%22%2C%20%22payment_object%22%3A%20%22commodity%22%2C%20%22vat_type%22%3A%20%22vat20%22%7D%5D%2C%20%22client%22%3A%20%7B%22email%22%3A%20%22client_email%40mail.ru%22%2C%20%22phone%22%3A%20%22%2B71231234567%22%7D%2C%20%22company%22%3A%20%7B%22email%22%3A%20%22company_email%40mail.ru%22%2C%20%22sno%22%3A%20%22osn%22%2C%20%22payment_address%22%3A%20%22https%3A%2F%2Fkvell.com%22%7D%7D&split_data=%5B%7B%22service_id%22%3A%20%22343-23%22%2C%22amount%22%3A%201000%2C%22description%22%3A%20%22%22%2C%20%22metadata%22%3A%20%7B%7D%7D%5D

POST request

<form action="https://pay.kvell.group/checkout/cascade" method="POST">
    <input type="hidden" name="api_key_1" value="d0aea12e-f94a-47ac-9687-633f3f8167ac">
    <input type="hidden" name="api_key_2" value="ab64d7ee-cfd6-4f32-98ef-35996bd2815b">
    <input type="hidden" name="amount" value="10000">
    <input type="hidden" name="description" value="Product #1">
    <input type="hidden" name="signature" value="afc09ed74d83849d44c1f1906b10d20c147bf0eb25da940c020c980b3b44ca38">
    <input type="hidden" name="success_url" value="http://yoursite.com/success">
    <input type="hidden" name="fail_url" value="http://yoursite.com/fail">
    <input type="hidden" name="transaction" value="fbfe9f88-d5c7-4994-aed6-ee8003f4f342">
    <input type="hidden" name="customer_key" value="customer-123">
    <input type="hidden" name="extra_data" value='{"string": "string"}'>
    <input type="hidden" name="fiscal_data"
           value='{"items": [{"name": "TEST", "price": 10025, "quantity": 2, "sum": 20050, "measurement_unit": "kg", "payment_method": "full_payment", "payment_object": "commodity", "vat_type": "vat20"}], "client": {"email": "client_email@mail.ru", "phone": "+71231234567"}, "company": {"email": "company_email@mail.ru", "sno": "osn", "payment_address": "https://kvell.com"}}'>
    <input type="hidden" name="split_data"
           value='[{"service_id": "343-23","amount": 1000,"description": "", "metadata": {}}]'>
    <input type="submit" value="Pay">
</form>