# Installments and loans
The customer takes out a loan or installment plan directly on the invoice page. Mandarin sends the application to 15+ banks and MFIs at once, the customer chooses one of the approved offers and signs the agreement online. Mandarin transfers the funds to you.
HOW TO CONNECT
Installments work only through the unified payment form. There is no separate API for submitting applications: you create an invoice with the credit method, and the customer fills out the application on the Mandarin page. Credit products and rates are connected through your manager.
# Products
| Product | The customer pays | You receive |
|---|---|---|
| Loan | With overpayment — the customer pays the interest | The full purchase amount |
| Installment | No overpayment | The purchase amount minus the fee according to your rate |
| Installment with overpayment | A fixed overpayment of 5% of the amount | More than with an installment without overpayment: the customer pays part of the interest |
| Installment with a fixed discount | No overpayment up to the selected term, with overpayment for longer terms | You fix the discount for a term of 6, 10, 12, 18, 24, or 36 months |
On the page, loans and installments are shown as separate tiles. Which products are available to the customer is determined by the link settings and your rate.
The purchase amount is up to 3,000,000 RUB. For better approval rates, we recommend tickets up to 750,000 RUB.
# Terms
Terms are set on the payment link. For a specific invoice, they can be narrowed with the payment_method_options.credit.terms parameter — an array of terms in months, as strings:
"payment_method_options": {
"credit": { "terms": ["6", "12", "24"] }
}
The customer sees only the terms for which your rate is configured. If none of the passed terms is configured, the loan does not appear on the page.
# Customer journey
The application goes through three stages. A detailed guide with screenshots is available in the knowledge base (opens new window).
1. Application form
- Full name, phone, date of birth, consent to data processing → SMS code.
- Passport photo and selfie — can be uploaded right away or later.
- Passport details and address.
- Employment and income.
- INN (taxpayer ID), email, marital status, additional contact → Submit application («Отправить заявку»).
2. Review
The application is sent to the banks. The customer sees an offer search screen, then a list of approved offers with the amount and terms. If no bank approves, a decline screen is shown. If you have Dolki connected, the page offers them as an alternative.
3. Signing
The customer chooses an offer and signs the agreement: with an SMS code, with a passport photo and selfie, or via a link from the bank — depending on the lender. If the approved amount is less than the purchase amount, the customer can sign several offers or pay the remainder with another method.
# Application assistance
If the customer may need help, pass "assistance_is_required": true when creating the invoice. On a payment page opened from a link, the customer can mark that they need help themselves — for amounts from 30,000 RUB.
# Installments in the API
An operation with method: "credit", method_type: "credit" appears for the invoice.
| What happens | Operation (status) | Invoice (invoice_status) |
|---|---|---|
| Application form, review, offer selection | processing | pending |
| Banks declined | failed | pending if other methods are enabled. cancelled if the invoice had only the loan |
| Agreement signed | success, amount — loan amount | paid, or partially_paid if the loan did not cover the full amount |
Operation fields:
id— application ID;additional_id— ID of the selected bank offer;settlement_amount— how much you will receive under this offer;payment_method_metadata.loan_term— term in months.
NOTE!
success for a loan means that the customer signed the agreement. The funds arrive later: in 2–3 business days, and for amounts from 50,000 RUB — also after the cooling-off period ends.
# Cooling-off period
Since September 1, 2025, after signing a consumer loan, the customer has time to withdraw from the agreement without consequences. While the period is in effect, the lender does not transfer the funds.
| Loan amount | Cooling-off period |
|---|---|
| Up to 50,000 RUB | None |
| From 50,000 to 200,000 RUB | 4 hours |
| Over 200,000 RUB | 48 hours |
# Settlement
Funds come from the lender through Mandarin to your bank account 2–3 business days after the agreement is signed, plus the cooling-off period. The amount to be credited is in settlement_amount.
# Receipts
If fiscalization is enabled for the invoice, Mandarin generates the receipt.
# Refunds
Refunds for loans and installments are handled with Mandarin's support based on the customer's request:
- within 14 calendar days after the purchase — with Mandarin's involvement: you send the customer's request to vozvrat@m.mandarin.io, Mandarin prepares a letter with the bank details and returns the funds to the lender;
- after 14 days — you refund the customer yourself.
Whether the agreement can be cancelled without interest depends on the lender. Timeframes by bank, request templates, and the procedure are described in the refund guide (opens new window).