Payments and instalments: the parts, in plain words

40 parts and 15 phrases. Apps in this area include Stripe, PayPal, Adyen, Klarna, Afterpay, Affirm, Shop Pay Installments.

Taking paymentpayment.collectShowThe ways a buyer pays and how the charge is made.

Payment methodspayment.collect.methodShowWhat the buyer pays with.

How to extend

ProviderOne per storepayment providerOne payment provider takes online payments for a store; Litestore uses Stripe, and the methods offered are the ones turned on in the Stripe account.

Part	Litestore today	How to extend
Card`payment.collect.method.card`A card payment charges a credit or debit card through the payment provider.	Core`platform/stripe-payment-provider.ts`	Provider · one
Digital wallet`payment.collect.method.wallet`A digital wallet such as Apple Pay or Google Pay pays with a card stored on the buyer's phone or browser.	Core`platform/stripe-payment-provider.ts`	Provider · one
Local payment method`payment.collect.method.local_method`A local payment method is a country-specific way to pay, such as iDEAL or Bancontact, shown to buyers in that country.	Core`platform/stripe-payment-provider.ts`	Provider · one
Bank transfer`payment.collect.method.bank_transfer`A bank transfer payment gives the buyer account details to send money to, and the order is marked paid when the money arrives.	Plugin	Provider · one
Recorded tender`payment.collect.method.manual_tender`A recorded tender marks an order the staff created by hand as paid by cash, card, bank transfer or another named method.	Core`modules/orders/admin/manual-order.ts`	Provider · one
Cash on delivery`payment.collect.method.cash_on_delivery`Cash on delivery lets the buyer pay the courier when the parcel arrives.	Plugin	Provider · one
Saved card`payment.collect.method.saved_card`A saved card stores a reference to the buyer's card with the provider so a later order is paid without typing it again.	Plugin	Provider · one

Paying over timepayment.collect.instalmentShowPayment methods where a lender pays the store and the buyer pays the lender over time.

How to extend

ProviderMany side by sidepayment providerBNPL lenders are offered as methods on the payment provider's page; Litestore shows the ones turned on in Stripe.
SlotMany side by sidestorefront.slot.product.below_priceA lender's messaging plugin renders the instalment amount under the product price.

Part	Litestore today	How to extend
Equal instalments`payment.collect.instalment.equal_instalments`Pay in instalments splits the order into a few equal payments, often four over six weeks, while the store is paid in full up front.	Core`platform/stripe-payment-provider.ts`	Provider · manySlot · many
Deferred payment`payment.collect.instalment.deferred_payment`Pay later charges the buyer the full amount after a set period, such as 30 days, while the store is paid now.	Core`platform/stripe-payment-provider.ts`	Provider · manySlot · many
Monthly loan`payment.collect.instalment.monthly_loan`Monthly financing is a loan for the order paid back in monthly instalments over months, sometimes with interest.	Core`platform/stripe-payment-provider.ts`	Provider · manySlot · many
Per-instalment price`payment.collect.instalment.per_instalment_price`An instalment price message shows the per-instalment amount, such as four payments of 25, next to the product price.	Plugin	Provider · manySlot · many

How the charge is madepayment.collect.chargeShowThe page that takes the payment and the steps a charge goes through.

How to extend

EventMany side by sideevent.order.paid event.payment.capture_recordedA plugin subscribes to paid orders and captures instead of reading the provider directly.
Core onlyThe payment ledger and the webhook that writes it stay in core because order totals and refunds depend on the recorded amounts.

Part	Litestore today	How to extend
Hosted payment page`payment.collect.charge.hosted_page`A hosted payment page is run by the provider, which collects the payment details and returns the buyer to the store.	Core`platform/stripe-payment-provider.ts`	Event · manyCore only
Payment link`payment.collect.charge.payment_link`A payment link is a URL for a set amount or order that the store sends to a buyer to pay outside the cart.	Plugin	Event · manyCore only
Instant capture`payment.collect.charge.instant_capture`Instant capture authorises and collects the money in one step when the buyer pays.	Core`platform/stripe-payment-provider.ts`	Event · manyCore only
Authorise then capture`payment.collect.charge.authorise_then_capture`Authorise then capture places a hold on the buyer's funds at checkout and collects them later, such as when the order ships.	Plugin	Event · manyCore only
Bank authentication check`payment.collect.charge.bank_authentication`A 3D Secure check asks the buyer's bank to confirm the payment, for example with a code in the banking app.	Core`platform/stripe-payment-provider.ts`	Event · manyCore only
Payment webhook`payment.collect.charge.payment_webhook`A payment webhook receives the provider's messages about paid, refunded and disputed payments and records each one once, even when a message repeats.	Core`modules/orders/payments/payment-webhook.ts`	Event · manyCore only
Payment ledger`payment.collect.charge.payment_ledger`A payment ledger stores every authorisation, capture, refund and dispute as a row, and the order's paid amount is their sum.	Core`modules/orders/ledger-revenue.ts`	Event · manyCore only
Payment reconciliation`payment.collect.charge.reconciliation`Payment reconciliation compares recorded payments with the provider on a schedule and repairs orders whose payment message was missed.	Core`jobs/cron.payment-reconcile.ts`	Event · manyCore only
Store currency`payment.collect.charge.store_currency`The store currency is the one currency prices are set and charged in.	Core`modules/markets/currency.ts`	Event · manyCore only
Buyer currency`payment.collect.charge.buyer_currency`A buyer currency charges a shopper in their own currency, converted from the store's prices.	Plugin	Event · manyCore only

Fraud screeningpayment.collect.fraudShowChecks that flag or block risky payments before an order ships.

How to extend

ProviderMany side by sidefraud screening providerA screening service scores each payment and returns a risk level for the order.

Part	Litestore today	How to extend
Risk score`payment.collect.fraud.risk_score`A risk score is a number the screening service calculates for each payment from signals such as card, address and device.	Plugin	Provider · many
Block rule`payment.collect.fraud.block_rule`A block rule rejects a payment that matches a condition, such as a risk score over a limit or a mismatch between card and shipping country.	Plugin	Provider · many
Manual review queue`payment.collect.fraud.review_queue`A manual review queue holds flagged orders until a person approves or cancels them.	Plugin	Provider · many
Blocked buyer`payment.collect.fraud.blocked_buyer`A blocked buyer is an account the store has restricted or banned, whose checkouts are rejected.	Core`modules/customers/stage.ts`	Provider · many

After paymentpayment.afterShowMoney going back, disputes and the store's own payouts.

Refundspayment.after.refundShowMoney paid back to the buyer.

How to extend

EventMany side by sideevent.order.refundedA plugin subscribes to refunds to update its own records, such as reversing loyalty points.
Assistant toolMany side by sideproposeRefundThe assistant proposes a refund that staff approve before any money moves.

Part	Litestore today	How to extend
Full refund`payment.after.refund.full_refund`A full refund pays the whole order amount back to the original payment method.	Core`modules/orders/refunds/refund-requests.ts`	Event · manyAssistant tool · many
Partial refund`payment.after.refund.partial_refund`A partial refund pays back chosen items or an amount, with the share of discount, tax and shipping calculated per item.	Core`modules/orders/refunds/calculate-item-refund.ts`	Event · manyAssistant tool · many
Refund to store credit`payment.after.refund.store_credit_refund`A refund to store credit adds the refunded amount to the customer's balance at the store instead of returning money.	Core`modules/orders/refunds/refund-requests.ts`	Event · manyAssistant tool · many
Manual refund`payment.after.refund.manual_refund`A manual refund records money paid back outside the provider, such as in cash, so the order's totals stay correct.	Core`modules/orders/refunds/refund-requests.ts`	Event · manyAssistant tool · many
Refund request`payment.after.refund.refund_request`A refund request is raised for an order and waits for approval before the refund is paid.	Core`modules/orders/admin/refunds`	Event · manyAssistant tool · many

Disputes and chargebackspayment.after.disputeShowA buyer asking their bank to reverse a payment, and the store's answer.

How to extend

EventMany side by sideevent.order.disputed event.order.dispute_won event.order.dispute_lostA plugin subscribes to disputes to gather evidence or alert staff.

Part	Litestore today	How to extend
Dispute record`payment.after.dispute.dispute_record`A dispute record stores the disputed amount, the bank's reason code, the status and the evidence deadline for one payment.	Core`modules/orders/disputes.ts`	Event · many
Evidence checklist`payment.after.dispute.evidence_guide`An evidence checklist lists the documents to submit for a dispute's reason code, such as tracking or a refund policy.	Core`modules/orders/disputes.ts`	Event · many
Evidence deadline alert`payment.after.dispute.deadline_alert`An evidence deadline alert flags disputes that still need a response before their deadline.	Core`modules/orders/admin/order-dispute-panel.tsx`	Event · many
Dispute assignment`payment.after.dispute.assignment`Dispute assignment names the staff member who handles a dispute.	Core`modules/orders/assign-dispute.ts`	Event · many
Evidence submission`payment.after.dispute.evidence_submission`Evidence submission sends the documents for a dispute to the bank through the payment provider.	Plugin	Event · many
Dispute resolve rule`payment.after.dispute.auto_resolve_rule`A dispute resolve rule refunds a new dispute without contesting it when it matches a condition, such as an amount under a limit.	Plugin	Event · many

Payouts and feespayment.after.payoutShowMoney moving from the provider to the store, and from the store to sellers.

How to extend

Core onlySeller ledgers and payouts stay in core because they are conserved amounts tied to orders.
Assistant toolMany side by sideproposeVendorPayoutThe assistant proposes a seller payout that staff approve.

Part	Litestore today	How to extend
Store payout`payment.after.payout.store_payout`A store payout moves collected money from the payment provider to the store's bank account on a schedule.	Plugin	Core onlyAssistant tool · many
Processing fee`payment.after.payout.processing_fee`A processing fee is the percentage plus fixed amount the provider keeps from each payment, used here to estimate margin.	Core`platform/config/pricing.ts`	Core onlyAssistant tool · many
Seller payout`payment.after.payout.seller_payout`A seller payout pays a marketplace seller their share of sales from the seller's ledger balance, recorded by staff.	Core`modules/vendors/vendor-ledger.ts`	Core onlyAssistant tool · many
Split payment`payment.after.payout.split_payment`A split payment sends each seller's share of an order to the seller's own provider account automatically.	Planned	Core onlyAssistant tool · many

Payments and instalments

What the phrases mean

Phrases left out

Sources