Payments & Gateways
Payment gateways are plug-ins: you add one by choosing its provider key and entering its credentials (API key/secret and any extra config), along with…
How are payment gateways added as plug-ins (provider key, credentials, fees)?
Payment gateways are plug-ins: you add one by choosing its provider key and entering its credentials (API key/secret and any extra config), along with its fee structure (a percentage…
What's typically required to configure a gateway (key/secret)?
Configuring a gateway is usually just a username/password or an API key/secret, with sensible default configuration provided per platform.
How does the system record gross, fee, and net received per transaction?
For each payment the system records the gross amount, the fee deducted, and the net amount received — three distinct figures.
Why do gateways not remit the full amount, and how is the ~2–3% fee accounted for?
Payment providers deduct a processing fee (typically around 2–3%) before remitting, so the business receives less than the order total.
How are capture, refund, fee, and void recorded as individual transactions?
Each financial event against a payment — a capture, a refund, a fee, a void — is recorded as an individual transaction (a ledger line with its type, amount, provider reference, and time).
What payment states exist (Pending, Paid, COD, Failed, Refunded)?
An order's payment state is one of: Pending (awaiting payment), Paid (received), COD (cash on delivery, to be collected), Failed (payment attempt failed), or Refunded (money…
How is a payment captured but order-failed scenario auto-resolved (no orphaned charge)?
If a payment is captured but the order then fails, the system auto-refunds or voids the charge and alerts, so there's no orphaned charge — the customer isn't left paying for an order…
How is a chargeback/dispute flagged and settlement frozen?
When a chargeback or dispute is raised, the order is flagged, the relevant settlement is frozen, and an evidence workflow begins.
How is partial payment tracked, restricting fulfillment until a rule is met?
A partial payment is tracked with the balance due recorded, and fulfilment can be restricted until a payment rule is met (for example, fully paid, or paid above a threshold).