Pay in installments works right on the site: the customer picks a bank and the number of payments, and the bank pays you. You turn on the banks you have contracts with and decide whether the customer pays extra.
When you need this:
- Expensive appliances don't sell at once — the product shows “In installments from … /mo” and a calculator.
- No bank contract yet — demo mode, no applications to the bank.
- The customer pays the bank fee — a “Credit markup” line.
- Installments for part of the catalog — limits per bank.
Where to start: the “Credit and pay in installments” card → a bank and its keys.
What the credit module can do
- Eight programs — PrivatBank, monobank, Sense Bank, A-Bank, PUMB and the PayLater service. Each is a separate payment method.
- A button with a calculator on the product page and the monthly payment in product cards.
- Credit markup — by term, per month or by product price, or no surcharge.
- Restrictions — amounts, categories, manufacturers, individual products, specials and coupons.
- Demo mode — credit on the site without a bank contract.
- Order statuses — based on the bank's response.
- Application operations — confirm, cancel, refund and refresh the status in the Elbuz order card.
How to connect a bank
You need an online installment contract with the bank for your web store. The bank gives you the connection data: store ID and password, a token or a login — each bank has its own (see the table below).
- Open the module screen — the “Credit and pay in installments” card (where it is).
- Turn on the module with the “Enabled” switch at the top of the screen. Without it, no bank works.
- Turn on a bank with the switch in its card header — the card expands.
- In “Bank mode: test / production” choose “Production” and enter the bank's data in “Live keys”. To check without real applications, choose “Test” and fill in “Test keys” (more).
- Set the terms: periods, minimum price, markup (below).
- Click “Save”.
1
Credit and pay in installments2
Credit markup- Opens the credit screen: banks, keys, terms and markup.
- The credit markup line in the order totals; turn it off and the customer pays no extra.
1
Enabled switch2
Demo mode (no bank contract)3
Button on the site4
Still to set up5
Banks on- The master switch: without it no bank works.
- Credit shows on the site, but no applications go to the bank.
- The text on the credit button and the bank icons.
- What is still missing: banks without keys, test mode, demo.
- How many of the eight banks are turned on.
A bank won't save without the data for its selected mode: the field shows “Required — the module will not work without it”. Demo mode needs no keys.
The button on the product page comes from the “Pay in installments” block in the design editor: the “Product page” page → the “Photos and purchase” section → blocks. The button label (“Button Text”, “Buy on credit” by default) and the bank icons are set in the “Button on the site” block.
For PUMB, copy the “PUMB callback address” from the bank card and send it to your bank manager.
How the window works in general is covered in “Store settings”.
Which banks are available and how they differ
You can turn on several programs — the customer chooses.
| Card in the app | What the bank gives you | Test mode | Status changes by itself |
|---|---|---|---|
| Pay in Installments (PrivatBank) | Store ID and password | yes | yes |
| Instant Installments (PrivatBank) | Store ID and password | yes | yes |
| Purchase in Installments (monobank) | Store ID and password | yes | yes |
| Easy Installments (Sense Bank) | Store ID and password | yes | no |
| Credit (Sense Bank) | Partner login, password and ID, point-of-sale ID | yes | no |
| Pay in Installments (A-Bank) | Store ID and password | no | yes |
| PayLater | API token, tariff IDs | no | no |
| Pay in Installments (PUMB) | Login, password, point-of-sale code, partner name | yes | no |
What sets individual programs apart:
- PrivatBank. “Installment type” is the program from your contract: Pay in installments “Standard” or Pay in installments “Money in period”; for instant installments — “Instant installment” or Instant installment “Promo”. “Hold the amount until confirmation” blocks the money on the customer's card and charges it when you confirm the order.
- monobank and PUMB. The customer confirms the application in the bank's app and doesn't go to the bank's site.
- Sense Bank “Easy Installments”. The customer's installment page is the same in both modes — check your first real purchase with a small amount.
- Sense Bank “Credit”. The customer fills in the bank's credit form on the “Your order has been placed!” page. Terms and price come from the “Credit subproducts” table: subproduct code, grace period in months, formula (
price+500— UAH 500 on top of the price). The bank provides the table. - PayLater. The customer enters last name, first name, patronymic, tax number (ITN) and phone. “PayLater tariffs by term” — a tariff ID for each term from your service manager. “Do not send data to PayLater” — the application doesn't go to the service, your manager files it. The customer's data and term are in the Elbuz order card, “Payment” section, “PayLater applicant data” block.
1
Bank switch2
State pill3
Bank mode: test / production4
Hold the amount until confirmation5
Test keys, in use now6
Advanced- Turns the bank program on for the site.
- Shows whether keys are set and in which mode.
- Test or Production: which keys applications go with.
- The money is held on the customer's card until you confirm.
- The key set of the selected mode; the other one is collapsed.
- The bank address; leave it empty.
What the customer sees
- On the product page — “In installments from UAH 1,250/mo” and a “Buy on credit” button with bank icons. The payment is the lowest among the banks, for the longest term. If no bank gives credit for the product, the block isn't shown.
- Calculator — bank and term, “Monthly payment” and “Total amount”. “Add to cart and check out” opens checkout.
- In product cards — “from UAH 1,250/mo” under the price.
- At checkout — each program is a separate payment method, for example “monobank - Purchase in Installments”. Under the selected one, the customer picks a term with the monthly payment.
- In the totals — “Credit markup”, if the customer pays extra.
- After confirming — the bank's site, the bank's app or the credit form (depending on the bank). If the bank doesn't respond — an error message and “Try again”.
1
Choose a bank2
Choose the credit term3
Monthly payment4
Total amount- The banks that give credit for this product.
- The terms from the bank settings.
- The monthly payment including markup.
- How much the customer pays in total.
Credit on the product, in cards and at checkout is shown only when the customer pays in hryvnias.
Terms and who pays for installments
Terms and markup are set separately in each bank's card.
Terms
- “Minimum months” and “Maximum months” — the range the customer chooses from. Set both as in your contract: the module fills empty fields with its own limits.
- “Available terms” (Sense Bank “Easy Installments”, PayLater, PUMB) — terms separated by commas, for example
3,6,9. In the calculator and at checkout, the customer chooses only from them, within the minimum and maximum.
Markup type
| Markup Type | How it is calculated | Example |
|---|---|---|
| Fixed | The “Markup by term, %” table: term — percentage of the price. A term not in the table means no surcharge. The table is prefilled with the bank's default values | 11.5 under “6” — +11.5% for 6 months |
| Monthly | “Monthly percent” × number of months | 2.9 — +34.8% for 12 months |
| By product price | The “Price from”, “Price to”, “Markup” table — an amount in hryvnias per range. “Price to” 0 — no upper limit | 0–5000 → 200: up to UAH 5,000 the surcharge is UAH 200 |
1
Markup type2
Row for 6 months- How the surcharge is calculated: fixed, monthly or by product price.
- The percentage added to the price for this term; 0 means no surcharge.
- The customer pays no extra — “Fixed” with
0under the terms you need, or “Monthly” with an empty or0“Monthly percent”. - “Acquiring Fee (%)” is added on top of the whole amount,
0— don't add it. - PrivatBank instant installments calculate the surcharge by type: “Instant installment” — 1.9% per month, “Promo” — 0.99%. The table and the markup type don't apply here.
- A percentage next to a category or manufacturer in the “Which products” group is an extra surcharge on the price of those products. With several categories, the highest percentage is taken; the manufacturer's is added. The bank markup is calculated from this price.
The surcharge in the totals is shown by a separate “Credit markup” card in the same section. It is turned on together with the module. Turn it off and the customer won't pay extra, even if the table has percentages.
Which products and amounts get credit
“Minimum price” and “Maximum price” limit both the cart total and the price of each product per 1 pc., 0 — no limit. With a minimum of 3000, a cart with four cases at UAH 1,000 each won't get credit.
“Filter mode” in the “Which products” group:
| Mode | Credit is given |
|---|---|
| All products | for the whole catalog |
| Whitelist | only for “Allowed products” and products from “Category filter” or “Manufacturer filter” |
| Blacklist | for everything except the categories and manufacturers in the filters |
| Markup only | for the whole catalog; the filters only add a percentage |
“Excluded Products” are never sold on credit with this bank, whatever the mode.
The “Restrictions” group:
- “Disallow promotional products” and “Disallow out-of-stock products” (quantity
0) — such products are sold for full payment only. - “Disallow Specials” and “Disallow discounts” — the product is sold on credit at the regular price, without the special or the quantity discount. The difference goes into “Credit markup”.
- “Disallow coupons” — when the customer chooses this bank, the coupon is removed.
If one product in the cart doesn't meet the bank's conditions, the bank disappears from the payment methods for the whole order.
The “Where to show” group: “Geo zone” — the bank only for addresses in this zone (“All zones” — for everyone). “Sort Order” — a smaller number goes higher in the calculator and at checkout.
Demo mode and test keys
Credit without a bank contract
Turn on “Demo mode (no bank contract)” in the “Module demo mode” block and the banks you need — no keys required. Terms and payments are calculated from the bank settings.
- The button has a “demo” mark. The calculator shows “Demo mode: no application is sent to the bank”, checkout — “Demo mode: the order is placed without an application to the bank”.
- The order gets the store's new-order status.
- The customer reads: “Order #… is accepted as “Pending” — a manager will contact you about the payment”.
The mode turns off by itself on saving, once an enabled bank has all the keys for its selected mode. Before that, the right side shows “After saving, demo mode turns off by itself: keys are set for “…””.
Test and production mode
PrivatBank, monobank, Sense Bank and PUMB have two key sets: “Live keys” and “Test keys”. “Bank mode: test / production” chooses which set the applications use. The set for the selected mode is expanded and marked “in use now”, the other one is behind the “Show” link.
- “Test” — test keys from the bank, no money moves.
- “Production” — real purchases.
Both sets are kept: after testing, just switch the mode. New monobank, Sense Bank and PUMB cards start in “Test”, PrivatBank in “Production”; in test mode the right side reminds you with “Test mode — switch to live before launch”.
A-Bank and PayLater have no test mode — check the first purchase with a small amount.
Leave “Bank API address” in the collapsed “Advanced” section empty: the module knows the banks' addresses. Enter only a new address from the bank, https:// only.
Order statuses and what happens to the order next
The status an order gets after the bank's response is chosen in the “Order statuses” block. These are site statuses; Elbuz maps them when orders are loaded.
| Field | When it is set |
|---|---|
| “Created” status | The application was sent to the bank — for all banks |
| “Pending” status | The application is being processed, or PrivatBank blocked the money until you confirm |
| “Paid” status | The bank approved the credit, or you confirmed the shipment |
| “Failed” status | The bank declined: customer not found, not enough limit, the customer refused or didn't confirm in time |
| “Cancelled” status | The application was cancelled |
| “Rejected” status | PrivatBank rejected the application |
After “Created”, the status changes by itself only with PrivatBank, monobank and A-Bank. Sense Bank, PUMB and PayLater don't sign their responses, so the module doesn't change the status based on them. Click “Refresh status” in the order card and change the order status according to the bank's response.
The application in the order card
The order arrives in Elbuz with its program's payment type, for example “PrivatBank installments” or “monobank Purchase in Installments”. The class is “Credit or instalments”.
The order card has a “Credit application: …” block with the bank name. It shows the application state from the bank, the amount, term, monthly payment and the application number at the bank.
Only the buttons available for the application right now are shown:
| Button | What it does | Banks |
|---|---|---|
| Confirm shipment | The application is waiting for the store and the goods have shipped: the bank transfers the money. The order gets the “Paid” status | PrivatBank, monobank, Sense Bank “Easy Installments”, A-Bank, PUMB |
| Cancel application | The product is unavailable or the customer changed their mind. The order gets the “Cancelled” status and the hold on the money is lifted | the same |
| Refund | After confirmation, refunds only the full credit amount: keep the suggested amount. The order status won't change until the bank completes the refund | monobank, Sense Bank “Easy Installments”, A-Bank |
| Refresh status | Gets the application state from the bank and shows it in the block | all except “Credit (Sense Bank)” |
With PUMB and PrivatBank, refunds are made in the bank's merchant account. “Credit (Sense Bank)” has no buttons: you handle everything in the Sense Bank partner account.
Before each operation the app asks for confirmation with the warning “This operation cannot be undone.”. The order status changes the same way as after a bank notification, and a record with the result appears in the order history.
If the store doesn't respond, the app shows “It is unknown whether the operation went through…” and a “Retry” button. It repeats the same operation: the application isn't sent a second time. Clicking the button again is a new operation.
Only a user with the “Payment operations: refund, hold, credit” permission can confirm, cancel and refund — by default, the owner. “Refresh status” is available to anyone who can see the order.
Scenarios
The store is launching, the contract is still being signed
“Demo mode (no bank contract)”, “Purchase in Installments (monobank)” and “Pay in Installments (PrivatBank)” are on, “Maximum months” is 12. Products show the monthly payment, and orders arrive without an application to the bank. Once the bank gives you keys, enter them and save — demo turns off by itself.
Washing machines in 4 payments with no overpayment
Markup type is “Fixed”, the table has 0 under 2, 3 and 4, “Minimum months” is 2, “Maximum months” is 4. The customer pays the site price, there is no “Credit markup” line. You pay the bank fee.
Installments only for laptops from UAH 10,000
“Filter mode” is “Whitelist”, “Category filter” has “Laptops”, “Minimum price” is 10000. There is no button on mice and bags, and with a mouse in the cart the bank disappears from checkout.
A made-to-order fridge: check availability first
In the “Pay in Installments (PrivatBank)” card, turn on “Hold the amount until confirmation”. The money is blocked, the order is in the “Pending” status. The item is available — “Confirm shipment” in the order card; it isn't — “Cancel application”, and the hold is lifted.
Several banks to choose from
2–3 banks with contracts are on, “Sort Order”: 1 — the one better for the customer, then 2, 3. The customer compares payments and chooses.
What to do when credit doesn't work
| What you see | Why | What to do |
|---|---|---|
| The bank isn't among the payment methods | The module or bank is off; the customer isn't paying in hryvnias; the amount is out of range; a cart product fails “Which products” or “Restrictions”; the address isn't in the zone | Check the switches, “Minimum price”, “Maximum price”, “Filter mode”, “Restrictions”, “Geo zone” and save |
| The product page has no “Buy on credit” button | The product design has no “Pay in installments” block, or no bank gives credit for this product | Add the block to the “Photos and purchase” section, check the price limits and the bank filters |
| The bank approved, but the order status is “Created” | Sense Bank, PUMB and PayLater don't change the status themselves | Get the bank's response with “Refresh status” and set the status yourself. For “Credit (Sense Bank)”, check the application in the bank's account |
| The customer isn't redirected to the bank, the site shows an error | Wrong keys, or keys for the other mode | Paste the keys again into the set for the bank's selected mode. Still not working — Elbuz support will check the bank's response |
| Applications don't show up in the bank's account | The bank is in “Test” or demo mode is on | Switch the bank mode to “Production”, check “Demo mode” on the right |
| The customer sees “Your cart has changed since the order was placed” | The cart changed after the order: a product, quantity or coupon | The customer just needs to place the order again — the application will go with the new amount |
FAQ
Is this the same as monobank card payments?
No. Card payments are a separate monobank module. “Purchase in Installments (monobank)” is an installment program in the credit module, with its own keys from the bank.
Why is the amount in the product calculator different from checkout?
The calculator counts from one product, checkout from the whole cart. The markup is also calculated from the cart total.
How do I block credit for one product?
Add it to “Excluded Products” in each bank's card.
What happens if I turn off a bank or the module?
The bank disappears from the product and checkout. Keys and conditions are kept: turn it back on and everything is in place.
The zone I need isn't in the “Geo zone” list — what do I do?
Elbuz support creates the zone, for example your region. Then choose it in the “Where to show” group of the bank card.
How do I confirm or cancel an application?
Open the order in Elbuz: in the “Credit application” block, click “Confirm shipment” or “Cancel application”. The buttons are there while the application is waiting for the store. For “Credit (Sense Bank)”, this is done in the Sense Bank partner account.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → “Credit and pay in installments”
- Access rights
- the “Store settings” window in group permissions; application operations — the “Payment operations: refund, hold, credit” permission
- Prepare
- a contract with the bank for online installments, connection data from the bank
Related topics
- If you need to understand how the store settings window works — Store settings.
- If you need regular monobank card payments — monobank payments.
- If the coupon is removed with credit — Store coupons.
