Telebirr, Chapa & CBE Birr Payment Checkout Integration

1. Overview & Business Value#

Nehabi provides native integration with Ethiopia's leading digital financial payment networks.

1. Supported Payment Rails#

{screenshot:nehabi-payment-gateways-config}

2. Step-by-Step Telebirr Configuration#

1. Navigate to Website → Configuration → Payment Providers.
2. Select Telebirr.
3. Under the Credentials tab, enter:
   • App ID: Merchant App ID issued by Ethio Telecom.
   • App Key: Secret API encryption key.
   • Short Code: Assigned merchant till number.
   • Public Key: Telebirr RSA public verification key.
4. Set the state to Enabled and click Save.

2. Prerequisites & Access Permissions#

• Required Modules: website, website_sale, smart_backend_theme
• Security Access Groups:
  • Website Designer (Technical ID: website.group_website_designer)
  • eCommerce Manager (Technical ID: website_sale.group_website_sale_manager)
• Master Data Dependencies: Established product catalog, defined multi-currency pricelists, and configured payment provider keys.

3. Step-by-Step UI Execution & Verification#

Step 1: Navigating to the Nehabi Management Interface#

1. Access your SmartERP portal at https://smarterp.et/odoo.
2. Open the main App Switcher and select Website.
3. Click the Go to Website button on the top-right control bar.

{screenshot:60-local-payment-gateway-integration-step1-navigation}

Step 2: Executing Configuration and Publishing#

1. Select the target page or e-commerce setting.
2. Apply layout adjustments or parameter modifications.
3. Verify live presentation across desktop and mobile viewports.

{screenshot:60-local-payment-gateway-integration-step2-verification}

4. Advanced Configuration Points#

• Scheduled Crons: website.ir_cron_sitemap_generator regenerates XML sitemaps every 24 hours.
• Multi-Website Support: SmartERP supports multiple independent websites running off a single database with dedicated domains.

5. Comprehensive Troubleshooting Matrix#