EcoCash is a mobile phone-based payment system and digital wallet in Zimbabwe. It allows customers to send money, pay bills, and purchase goods using either US dollars (USD) or local currency through the EcoCash mobile app.

By integrating EcoCash with SalesPlay POS, you can securely accept EcoCash payments directly from your POS.

Before You Begin

Make sure you have:

• A SalesPlay account
• An active EcoCash merchant account
• Your EcoCash API credentials (API Key and API Secret)

---

Step 1: Configure EcoCash in SalesPlay Back Office

1. Log in to the SalesPlay Back Office.
2. Go to Settings → Features.
3. Find Payment Gateways.
4. Enable the feature and click Save.
5. Go to Settings → Payment Gateways.
6. Click Add Payment Gateway.
7. Select EcoCash Payments.
8. Enter the following information:
   • Device Name
   • API Key
   • API Secret
   • Currency
   • Target Terminal
9. Make sure the Status is ON.
10. Click Save.

Your EcoCash payment gateway is now configured.

---

Step 2: Assign EcoCash to a Payment Type

1. Go to Settings → Payment Types.
2. Open an existing payment type (such as Card) or create a new one.
3. Enable Payment Gateway.
4. Select EcoCash from the Payment Gateway drop-down list.
5. Click Update.

Your payment type is now linked with EcoCash.

---

Step 3: Enable EcoCash on SalesPlay POS

1. Open the SalesPlay POS application.
2. Sign in with your POS account.
3. Go to Settings → Payment Gateway.
4. Enable EcoCash.
5. SalesPlay POS will automatically download the payment gateway configuration from the Back Office.

The POS is now ready to accept EcoCash payments.

---

Step 4: Process an EcoCash Payment

To verify the integration:

1. Create a new sale in SalesPlay POS.
2. Tap Charge.
3. Select the payment type linked to EcoCash.
4. Enter the customer’s registered EcoCash mobile number.
5. Tap OK.
6. The payment request will be sent to the customer’s EcoCash account.
7. Ask the customer to authorize the payment on their mobile device.
8. Once the payment is approved, the transaction will be completed automatically and the receipt can be printed.

---

Troubleshooting

If EcoCash payments are not working, check the following:

• The Payment Gateways feature is enabled in the Back Office.
• The API Key and API Secret are correct.
• The payment gateway Status is ON.
• The payment type is linked to EcoCash.
• The POS has synchronized the latest payment gateway settings.
• The customer is using the correct EcoCash registered mobile number.
• The merchant terminal is active and connected to the internet.

If the issue persists, contact your SalesPlay administrator or the SalesPlay Support Team.