Payments and checkout

Payment methods

Kufi → Commerce → Settings → Payments lists every payment method with an on/off switch: PayPal, bank transfer, cash on delivery and a custom gateway for your own payment page. Buyers choose at checkout.

Go to Kufi → Commerce → Settings → Payments. Each method has a switch that saves right away, and its own settings page. A method that isn't set up yet can't be switched on: its switch opens the setup page, and saving a complete setup switches it on.

When more than one method fits the cart, buyers choose at checkout. Subscriptions are always paid with PayPal.

PayPal

Card payments and PayPal balance, one-time and subscriptions, with refunds from the order screen. See Connect PayPal.

Bank transfer

  1. Enter the Bank details (account holder, bank, IBAN and BIC/SWIFT) and an optional note.
  2. Buyers see the details on the order received page and in their email.
  3. The order waits for payment and holds its items. When the money arrives, open the order and click Mark as paid: the buyer gets the receipt and digital items are delivered.

Unpaid bank transfer orders release their items after 7 days unless you change it under Kufi → Commerce → Settings → Inventory → Unpaid orders.

Cash on delivery

Offered only when every item in the cart ships. The order goes straight to To ship. Click Mark as paid once the courier has the money, or Cancel order if the buyer refuses it (the items go back in stock).

Custom gateway

Sends buyers to your own payment page, for example a local card processor, and takes its answer back. Both directions are signed with a secret you get on the settings page, using HMAC-SHA256, so nobody can mark an order paid without it. The settings page shows exactly which fields the page receives and must send back. Click Make a new secret if it ever leaks.

Other payment providers

A developer can add a provider (Stripe, for example) with a small plugin that registers it through the kufi_commerce_gateways filter; it then gets its switch, settings page and checkout choice like the built-in ones. Mada, STC Pay, Tabby and Tamara are planned.

Store status

The header of every Store screen shows:

  • Taking payments: at least one method is set up and on.
  • Test mode: PayPal is the only method on, and it's in Sandbox, so payments aren't real.
  • Checkout closed: no payment method is on, so buyers can't check out.

More in Payments and checkout

Still need help?

Tell us what you are trying to do and what you see. We read every message.