# 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:

  1. Selects Bank card («Банковская карта»).
  2. Enters the card number, expiration date, and CVC/CVV.
  3. Confirms the payment with an SMS code or in the bank app (3-D Secure).
  4. 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 — card or card2;
  • 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 is null.

# 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.