chapa-payments
Installation
SKILL.md
Chapa Payments
Chapa is a payment gateway for Ethiopia (telebirr, CBEBirr, M-Pesa, Awash, ebirr, cards, PayPal).
Base URL https://api.chapa.co/v1. Every server call is Authorization: Bearer <SECRET_KEY>.
The instructions below come from the official docs at https://developer.chapa.co and were
validated against a production integration. Follow them exactly; payment bugs cost real money.
Pick the integration
| Need | Use | Reference |
|---|---|---|
| Web or mobile app, any payment method, fastest and safest | Standard (hosted) checkout: server calls initialize, redirects to checkout_url |
this file |
| Static site, no backend for initialize | HTML checkout form posting to /v1/hosted/pay |
frontend.md |
| Embedded form on your page (public key only) | Inline.js ChapaCheckout |
frontend.md |
| Flutter app | chapasdk package (native or web checkout) |
flutter.md |
| Own UI for USSD / OTP wallets, POS, ERP | Direct Charge /v1/charges?type=... then /v1/validate |
advanced.md |
| Marketplace payouts to vendors | Subaccounts + subaccounts in initialize, or Transfers API |
advanced.md |