Skip to main content
A channel is an encapsulation of configuration sets that represents specific branding, payment methods and an online platform (website or mobile app) for ecommerce, or a physical store for in-person. Channels let you segregate transaction traffic by origin. The channel_id referenced in hosted-checkout-page and payments api points back to a channel configured here. Channels are managed in the dashboard under Settings → Acceptance. There is no public API for managing them.

​
Channel types

TypeForConfigured with
ECOMWebsites, mobile apps, payment links, or direct API integrations.A channel name and an integration subtype.
In-PersonPayments taken on a physical terminal.A channel name, merchant name, and bilingual receipt and address details.

​
How channel_id resolves

Every ecommerce business has a default channel. If you pass a channel_id when creating a payment, that channel processes it; if you don’t, the default channel does. A passed channel_id must be accessible by the API key used.

​
Create an ECOM channel

  1. Go to Settings → Acceptance and open the ECOM Channels tab.
  2. Select Add New Channel.
  3. Enter a Channel Name.
  4. Configure payment methods and checkout styling.
  5. Copy channel_id and use it for processing purposes.
You can create multiple ECOM channels per business, for example separate channels for your web store and mobile app.

​
Create an In-Person channel

Open the In-Person Channels tab and select Add New Channel. All fields are required:
  • Channel Name and Merchant Name.
  • Arabic Receipt Footer 1 / 2 and English Receipt Footer 1 / 2.
  • Arabic Address 1 / 2 and English Address 1 / 2.
Receipt and address details are captured in both languages so terminal receipts print correctly for either.