WowCodesDocs

Set up Chapa

Chapa takes payments in Ethiopia, in birr or US dollars, on Chapa's own payment page. Every payment is confirmed with Chapa before anything is credited.

Not for Rewards stores

Rewards (coins-only) products have no payment gateways.

Set it up

Buy and install Chapa from the add-on store, then open Payment Gateways Chapa.

  1. Enter your keys

    Your Chapa secret key and public key, from your Chapa dashboard. The keys decide test or live: CHASECK_TEST- and CHAPUBK_TEST- keys take test payments only. Both keys must be from the same mode; a test key beside a live one is refused when you save.

  2. Set up the webhook

    Choose a secret hash and save it as Webhook Secret. In your Chapa dashboard, under Webhooks, enter this gateway's webhook address and the same secret hash. Payments are credited without it, but the webhook catches buyers who close the page before they come back.

  3. Make the merchant pay the fees

    In your Chapa dashboard, set the fees to be paid by the merchant. If buyers pay them, Chapa reports more than the payment asked for, and each payment is held for review instead of credited.

  4. Try a test payment, then go live

    Switch Chapa on at checkout and make a small payment with your test keys. When it shows the success page, change both keys to your live ones at the same time.

If your store isn't in birr or dollars

Chapa charges in birr (ETB) or US dollars (USD) only. On a current kernel, a charge in any other store currency is converted with a live rate from the Exchange Rates plugin (one less than a day old) or, failing that, the fixed rate set on the gateway. With neither, Chapa isn't offered at checkout. On an older kernel, only stores in birr or dollars can use Chapa: update it from Software update. See Payment gateways.

Common questions

You seeWhat to do
"One key is a test key and the other a live key."Use both keys from the same mode: both test, or both live.
A payment is held for reviewChapa reported a different amount from the one charged, usually because buyers were set to pay the fees. Set the fees to the merchant (step 3).
A buyer paid but wasn't creditedPress Check with gateway on the payment request. See A customer paid but wasn't credited.
A paid payment showed "payment failed" (Chapa 1.0.6 and earlier)Fixed in Chapa 1.0.7: update it from Plugins. Chapa took those payments. They were credited by the webhook if it was set up; press Check with gateway on any that look unpaid rather than crediting by hand.

Money goes back to a buyer's card or account only from your own Chapa dashboard.

Something wrong or unclear on this page? Tell us at [email protected], or see how to get help.