Quick start

1. Explore the product#

Open the demo workspace to create a test order, explore payment links and check a fee calculation. The demo uses separate test data. It does not create a bank payment or transfer funds to a wallet.

2. Create an account with Telegram#

After Telegram sign-in, the merchant account opens. Website onboarding is at /account#applications; both the form and individual tracking at /account#applications/{id} stay inside the app.

A new payment and card intent require the merchant’s latest website-review application to be approved. Approval alone does not connect the payment gateway. If the review changes after dispatch, the existing operation remains available for status reads, reconciliation and a requested bank code.

3. Set up your store#

1. 1

   Choose a store name your customer will recognize.

2. 2

   Choose a default VAT rule. Each new invoice separately accepts customer fee and VAT shares from 0 to 100%.

3. 3

   Select the notifications you want to receive in Telegram.

4. 4

   Use the calculator to check a typical order amount.

4. Prepare a payment link#

Enter a clear order title, an amount and a currency. The customer gets a dedicated page with purchase details and the total due. An existing invoice keeps its original terms when your store settings change.

5. Check payment availability#

Manage invoices, API keys, widgets and webhooks from your account. Before payment, Kevmi checks the gateway configuration, merchant approval, amount and invoice terms. If the selected method is unavailable, checkout explains why.

For a new invoice in the interface, USD offers cards and Alipay; RUB offers SBP; USDT offers crypto. The API can also save USD + crypto for compatibility, but its live crypto payment is blocked with crypto_requires_usdt. USD and USDT are distinct, with no automatic conversion or assumed 1:1 rate. A crypto payment requires a separate USDT invoice.

For a new live card or Alipay payment, the current gateway supports only feeCustomerPercent=0 and vatCustomerPercent=100: the merchant covers the entire processing fee and VAT is added in full for the customer. Other shares can be saved and calculated on an invoice, but execution is blocked with unsupported_allocation. The server never silently changes saved terms. SBP and USDT crypto payments support every processing-fee share and have no VAT.