Payments

Setting Up MonCash Payments

Accept MonCash on your Cartva store in Manual Business mode (customers pay your number and upload a screenshot) or Automated API mode (payments verified automatically). Every field explained, plus how to confirm a MonCash order.

On this page

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 BusinessAutomated (API)
What you needA MonCash account (personal or business number)A MonCash merchant account with API access
How the customer paysSends the amount to your number, then uploads a screenshotIs redirected to MonCash and pays there
Who confirms the paymentYou, after checking your MonCash balanceMonCash, automatically
Best forStarting out, low volumeMany orders a day

Option A: Manual Business

Step 1: Turn it on

  1. Go to Settings → Payments.
  2. Turn on MonCash and open its settings.
  3. Choose Manual Business.

Step 2: Fill in the fields

FieldWhat to enter
ID typePhone 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 nameThe name customers will see in MonCash when they send the money. Use the exact name on the account so they trust the transfer
InstructionWhat the customer should do, step by step. You can use bold, strike and italic
Require payment proofCustomers must upload a screenshot of the transfer to finish checkout. Keep it on
Mark as paid upon customer confirmationThe 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 paymentLets 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:

  1. The order arrives in Orders, with the Payment proof attached.
  2. Open the order and click View next to Payment proof.
  3. 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.
  4. If the money arrived, change the status with Update status to Confirmed, then prepare the order.
  5. 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

  1. Go to Settings → Payments, turn on MonCash, open its settings.
  2. Choose Automated (API).
  3. Paste the Client ID and Secret Key.
  4. Tick Live mode for real payments. Leave it unticked to test with MonCash's sandbox.
  5. 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.

Share

Still stuck?

Email the Cartva team at customer@cartva.co with the name of your store and what you were trying to do. No store yet? Start free for 30 days.

Start your free trial