# Bank cards
The customer enters card details directly on the invoice page and confirms the payment via 3-D Secure. Funds are debited immediately.
# Russian bank cards
MIR, Visa, and Mastercard cards issued in Russia are accepted.
How the customer pays:
- Selects Bank card («Банковская карта»).
- Enters the card number, expiration date, and CVC/CVV.
- Confirms the payment with an SMS code or in the bank app (3-D Secure).
- Sees the successful payment screen or is redirected to your redirect URL.
If the payment fails, the customer can try again — with another card or another method. Failed attempts are kept in the invoice status.
Connection. To accept cards, you need a project in the personal account. It is selected in the payment link settings, on the Payment methods («Способы оплаты») tab. In the API, the method is passed as rus_card.
# Foreign cards
The customer pays with a card issued by a foreign bank. The payment flow is the same as for Russian cards.
Foreign cards are connected as a separate project. In the API, the method is passed as int_card; in the invoice status it appears as method: "card2".
If only foreign cards are available for the invoice, the tile is called Foreign card («Зарубежная карта»).
# Cards in the API
| What happens | Operation (status) | Invoice (invoice_status) |
|---|---|---|
| The customer opened the form | Does not appear in payment_breakdown | pending |
| The customer entered the card, payment in progress | processing | pending |
| Payment succeeded | success, amount — payment amount | paid or partially_paid |
| Bank decline or error | failed | Does not change |
Operation fields:
method—cardorcard2;method_type—cash;id— transaction ID in the Mandarin payment gateway. It is also shown in HeartBeat;additional_id— operation ID in processing;settlement_amount— amount to be credited, net of the fee. Appears after the fee is calculated, usually within a few minutes after payment; until then it isnull.
# Settlement
Funds are credited to your bank account on the next business day. For new companies — within up to 3 business days.
# Receipts
If cart.fiscal_receipt_is_required: true was passed when creating the invoice, or fiscalization is enabled on the link, a receipt is generated from the cart items after a successful payment.
# Refunds
A full or partial card refund is issued in the personal account or via the payment cancellation API.
← Payment methods SBP →