Skip to content

Connect a payment gateway

All plansOwner / ManagerUpdated 15 Nov 2026

What you'll do: connect your own payment gateway account to Hala, test it in sandbox mode, and choose where customers can use it: the online store, invoice payment links or the POS.

Before you start:

  • You need a merchant account with the gateway and its keys (from the gateway's merchant portal).
  • Your role needs the business settings permission (business_settings.access).
  • The money goes to your gateway account. Hala never uses its own keys for your payments.

Show me in the app

  1. Open Administration & Settings → Settings → Payment Gateways.

  2. On the left, choose the gateway. The list shows only the gateways available for your business. At the top of the gateway, the badges show Enabled or Disabled, and Configured or Not configured yet.

    1 Gateways · 2 Credential fields · 3 Enable this gateway · 4 Save gateway
  3. Fill in the Credential fields with the keys from your merchant portal (for example Secret key, Merchant ID, API key). Secret fields are never shown again after saving: leave them empty to keep the saved value, or tick Clear stored value to remove it.

    • Noqoody: instead of copying keys, use Connect with your Noqoody login: type your merchant Username and Password and press Connect. Hala gets the keys for you and doesn't keep the password.
  4. Switch on Sandbox / Test mode while you test with the gateway's test account. Switch it off to take real payments.

  5. Switch on Enable this gateway, then choose where it is offered:

    • Enable for Ecommerce storefront: the online store checkout;
    • Enable for Invoice URL: the payment link on invoices you send to customers;
    • Enable for POS / in-store: a payment button at the POS (QR code or request to the customer's app), where the gateway supports it.
  6. Press Save gateway.

  7. If the page shows Your webhook URL or Repoint your merchant dashboard webhook to the engine, press Copy and paste the address into your gateway account as described in the box. For Stripe and PayLater, also paste the Webhook secret you receive into the field and save again.

Was this page helpful?