Skip to content
LevaPay

The NatCash API to send money to wallets in Haiti

Send gourdes to NatCash wallets from your platform, check the account holder name before confirming and get the deposit confirmation, usually right away.

  • Account holder lookup
  • Usually credited instantly
  • The same API works for MonCash

What is the LevaPay NatCash API?

NatCash is the mobile wallet of Natcom, one of Haiti’s two major mobile carriers. The LevaPay NatCash API lets your platform send gourdes (HTG) to any NatCash wallet with just the recipient’s phone number.

Your system uses a REST API with JSON responses: look up the wallet holder, quote the transfer with the exact total, confirm it and receive the final status. Most NatCash transfers are credited instantly, so you can show the confirmation to your customer without waiting.

It is a great fit for remittance apps, digital wallets, P2P payment platforms and businesses that pay agents, suppliers or contractors in Haiti and want to offer NatCash alongside MonCash with a single integration.

MonCash is a trademark of Digicel Haiti and NatCash is a trademark of Natcom. LevaPay is an independent service. The LevaPay API is for sending money to NatCash wallets. It is not an official Natcom product.

REST API for Haiti

How to send money to NatCash with the API

  1. 1

    Create your account and TEST keys

    Sign up for free and generate an API user and a test PRIVATE_KEY. In the sandbox, use the test wallet 50940885084.

    Free
  2. 2

    Check the account holder

    GET /wallets/{wallet}?network=natcash returns the holder name so the sender can confirm the number is correct.

    GET /wallets/{wallet}
  3. 3

    Quote and confirm

    Quote with POST /transfers/quote (network "natcash") and confirm the quote_id with POST /transfers and a unique idempotency_key.

    POST /transfers
  4. 4

    Show the result

    The response usually comes back with status completed. If it shows another status, call GET /transfers/{id}.

    completed
NatCash API

Example: check the holder and send 5,000 HTG to NatCash

Holder lookup, quote and transfer with the NatCash API in TEST mode. For production, replace /test/v1 with /prod/v1 and use your PROD keys.

  • Authentication with the X-Api-User and X-Api-Key headers
  • The beneficiary field returns the NatCash account holder name
  • Test wallet 50940885084 in the sandbox
  • Up to 60 requests per minute per key
Read the docs
# 1) Look up the account holder
curl "https://api.levapay.dev/test/v1/wallets/50940885084?network=natcash" \
  -H "X-Api-User: your_api_user" \
  -H "X-Api-Key: your_PRIVATE_KEY"

# 2) Quote
curl -X POST https://api.levapay.dev/test/v1/transfers/quote \
  -H "Content-Type: application/json" \
  -H "X-Api-User: your_api_user" \
  -H "X-Api-Key: your_PRIVATE_KEY" \
  -d '{"network":"natcash","wallet":"50940885084","amount_htg":5000}'

# 3) Send
curl -X POST https://api.levapay.dev/test/v1/transfers \
  -H "Content-Type: application/json" \
  -H "X-Api-User: your_api_user" \
  -H "X-Api-Key: your_PRIVATE_KEY" \
  -d '{"quote_id":"qt_...","idempotency_key":"order-10025"}'

What to know about NatCash payouts

Wallet number

Use the Haitian number linked to NatCash: 8 digits, with or without the 509 prefix (for example 40885084 or 50940885084). Amounts are in gourdes, whole numbers, starting at 1 HTG.

Account holder lookup

GET /wallets/{wallet}?network=natcash returns the holder name and creates a 100 HTG verification quote. Confirm it with POST /transfers only if you want to send that amount; otherwise let it expire. A regular quote from POST /transfers/quote also includes the beneficiary field.

Crediting

NatCash transfers usually come back completed in the same response. Your integration should still handle pending and failed. If the transfer fails, the amount goes back to your balance.

TEST mode

In the sandbox, use the test wallet 50940885084: the transfer is completed instantly and debited from your TEST balance, without moving real money.

Note for the recipient

The note field (up to 64 characters) sets the text the recipient sees on the deposit. If you leave it out, LEVAPAY is used.

Why use LevaPay for NatCash payouts

Fewer transfers to the wrong number

Show the account holder name to the sender before confirming.

Instant confirmation

Most transfers come back with status completed in the same response.

Exact total before sending

Amount, fee and total in the quote, with no surprises for your customer.

No duplicate charges

The required idempotency_key prevents double charges when your system retries.

NatCash and MonCash together

The same code works for both networks: only the network value changes.

Sandbox with a test wallet

Test the whole flow with TEST keys and no real money.

NatCash API pricing

You pay 3.5% of each transfer, with no setup fee, no monthly fee and no funding fees. The account holder lookup has no separate cost. For example, for the recipient to get 5,000 HTG on NatCash:

Recipient gets
5,000.00 HTG
Fee (3.5%)
175.00 HTG
Total debited from your balance
5,175.00 HTG

See pricing and funding methods

Frequently asked questions

Is this the official NatCash API?

No. LevaPay is an independent service that lets businesses send money to NatCash wallets through its own API. NatCash is a trademark of Natcom.

Can I see who owns the wallet?

Yes. Call GET /wallets/{wallet}?network=natcash or check the beneficiary field in the quote before confirming the transfer.

Does the account holder lookup cost anything?

No. The lookup creates a 100 HTG verification quote that is only charged if you confirm it with POST /transfers. If you do not, it expires at no cost.

How long does a NatCash transfer take?

It is usually credited instantly, and the POST /transfers response already comes back with status completed.

What happens if a transfer fails?

If the transfer is not accepted, your balance is not debited. If it fails after being accepted, the status changes to failed and the amount is returned to your balance.

How do I test without real money?

Create a free account, generate TEST keys and use the wallet 50940885084. If your TEST balance is 0, ask your LevaPay contact for TEST balance.

Can I also send to MonCash?

Yes. With the same integration you send to MonCash by setting network to "moncash". MonCash transfers may stay pending for a moment.

Start sending to NatCash today

Create a free account, test the NatCash API with the test wallet and go live when you are ready.