MonCash, Digicel's mobile wallet, is the most used way to pay online in Haiti. On Cartva, a MonCash payment goes directly to your MonCash account: Cartva doesn't hold the money and takes no fee per sale on it.
There are two modes. Manual Business works with a simple MonCash number and you confirm each payment. Automated (API) needs MonCash merchant credentials and confirms payments by itself.
In short
- Go to Settings → Payments, turn on MonCash, open its settings.
- Manual Business: enter your number, payee name and instructions. Keep Require payment proof on. Confirm each order yourself after checking your MonCash account.
- Automated (API): paste your Client ID and Secret Key from the MonCash merchant portal, tick Live mode, save.
- MonCash is not offered when the cart contains print-on-demand or dropshipped products: those can only be paid by card.
Which mode should I choose?
| Manual Business | Automated (API) | |
|---|---|---|
| What you need | A MonCash account (personal or business number) | A MonCash merchant account with API access |
| How the customer pays | Sends the amount to your number, then uploads a screenshot | Is redirected to MonCash and pays there |
| Who confirms the payment | You, after checking your MonCash balance | MonCash, automatically |
| Best for | Starting out, low volume | Many orders a day |
Option A: Manual Business
Step 1: Turn it on
- Go to Settings → Payments.
- Turn on MonCash and open its settings.
- Choose Manual Business.
Step 2: Fill in the fields
| Field | What to enter |
|---|---|
| ID type | Phone number if customers send money to a number, Merchant ID if you have one |
| Phone (or Merchant ID) | The number or ID that receives the money. Double-check it: every payment goes there |
| Custom dial code (optional) | A USSD shortcut customers can dial, for example *123*1*3# |
| Payee name | The name customers will see in MonCash when they send the money. Use the exact name on the account so they trust the transfer |
| Instruction | What the customer should do, step by step. You can use bold, |
| Require payment proof | Customers must upload a screenshot of the transfer to finish checkout. Keep it on |
| Mark as paid upon customer confirmation | The order is marked paid as soon as the customer says they paid, without your check. Leave it off unless you trust every customer |
| Enable contact seller before payment | Lets the customer skip payment and message you first, for example to ask a question |
A good instruction:
Send the exact total to 3XXX-XXXX (name: My Store) with MonCash, then upload the confirmation screenshot below. Your order is confirmed as soon as we see the payment.
Step 3: Save and test
Click Save Configuration, then place a test order from your store in a private window. Check that the number, the payee name and the instruction appear correctly at checkout.
Step 4: Confirm MonCash orders
When a customer pays in manual mode:
- The order arrives in Orders, with the Payment proof attached.
- Open the order and click View next to Payment proof.
- Check in your MonCash account that you received the exact amount, from the right sender, at the right time. A screenshot alone is not proof: it can be edited.
- If the money arrived, change the status with Update status to Confirmed, then prepare the order.
- If it didn't, contact the customer before doing anything else.
Option B: Automated (API)
Step 1: Get your API credentials
Log in to your MonCash merchant (business) portal and find the API section. Copy the Client ID and the Secret Key. Contact Digicel if your account doesn't have API access yet.
Step 2: Enter them in Cartva
- Go to Settings → Payments, turn on MonCash, open its settings.
- Choose Automated (API).
- Paste the Client ID and Secret Key.
- Tick Live mode for real payments. Leave it unticked to test with MonCash's sandbox.
- Click Save Configuration.
The Secret Key is stored encrypted. Never share it, never put it in a message to a customer.
Step 3: Test
Place a test order with Live mode off and pay in the sandbox. The order should move to paid on its own. Then tick Live mode and save.
Troubleshooting
MonCash doesn't show at checkout
- Check that MonCash is turned on and the configuration is saved.
- In manual mode, fill in the phone number or merchant ID.
- In API mode, check the Client ID and Secret Key have no extra spaces.
- If the cart has a print-on-demand or dropshipped product, only the card is offered. This is expected.
Automated payments fail
- Check the Client ID and Secret Key for typos.
- Live mode must match the credentials: live keys with Live mode ticked, sandbox keys with it unticked.
A customer can't finish checkout
With Require payment proof on, checkout needs the screenshot. Ask the customer to upload a picture of the MonCash confirmation message.
Frequently asked questions
Does Cartva take a commission on MonCash payments?
No. MonCash payments go straight to your MonCash account, so Cartva takes no fee per sale on them. MonCash's own fees still apply.
Do MonCash payments appear in my Cartva wallet?
No. The money is already on your MonCash account. The wallet only holds card payments collected by Cartva.
Can customers pay print-on-demand products with MonCash?
No. For print-on-demand and dropshipped products, Cartva pays the supplier before you are paid, so it must collect the payment itself: only the card is offered for those carts.
Can I use the same setup for NatCash?
Yes. NatCash has the same two modes and the same manual fields. In API mode it asks for a Merchant ID and an API Key instead of a Client ID and Secret Key.
