Fewer transfers to the wrong number
Show the account holder name to the sender before confirming.
Send gourdes to NatCash wallets from your platform, check the account holder name before confirming and get the deposit confirmation, usually right away.
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.
Sign up for free and generate an API user and a test PRIVATE_KEY. In the sandbox, use the test wallet 50940885084.
FreeGET /wallets/{wallet}?network=natcash returns the holder name so the sender can confirm the number is correct.
GET /wallets/{wallet}Quote with POST /transfers/quote (network "natcash") and confirm the quote_id with POST /transfers and a unique idempotency_key.
POST /transfersThe response usually comes back with status completed. If it shows another status, call GET /transfers/{id}.
completedHolder lookup, quote and transfer with the NatCash API in TEST mode. For production, replace /test/v1 with /prod/v1 and use your PROD keys.
# 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"}'
<?php
const BASE = 'https://api.levapay.dev/test/v1';
function levapay(string $method, string $path, ?array $body = null): array {
$ch = curl_init(BASE . $path);
$opts = [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-Api-User: your_api_user',
'X-Api-Key: your_PRIVATE_KEY',
],
];
if ($body !== null) {
$opts[CURLOPT_POSTFIELDS] = json_encode($body);
}
curl_setopt_array($ch, $opts);
return json_decode((string) curl_exec($ch), true);
}
$holder = levapay('GET', '/wallets/50940885084?network=natcash')['data'];
echo $holder['beneficiary']; // account holder name
$quote = levapay('POST', '/transfers/quote', [
'network' => 'natcash', 'wallet' => '50940885084', 'amount_htg' => 5000,
'note' => 'Order 10025',
])['data'];
$transfer = levapay('POST', '/transfers', [
'quote_id' => $quote['quote_id'],
'idempotency_key' => 'order-10025',
])['data'];
echo $transfer['status']; // usually "completed"
const base = 'https://api.levapay.dev/test/v1';
const headers = {
'Content-Type': 'application/json',
'X-Api-User': 'your_api_user',
'X-Api-Key': process.env.LEVAPAY_KEY,
};
const api = (method, path, body) =>
fetch(base + path, { method, headers, body: body && JSON.stringify(body) })
.then((r) => r.json());
const { data: holder } = await api('GET', '/wallets/50940885084?network=natcash');
console.log(holder.beneficiary); // account holder name
const { data: quote } = await api('POST', '/transfers/quote', {
network: 'natcash', wallet: '50940885084', amount_htg: 5000,
note: 'Order 10025',
});
const { data: transfer } = await api('POST', '/transfers', {
quote_id: quote.quote_id,
idempotency_key: 'order-10025',
});
console.log(transfer.status); // usually "completed"
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.
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.
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.
In the sandbox, use the test wallet 50940885084: the transfer is completed instantly and debited from your TEST balance, without moving real money.
The note field (up to 64 characters) sets the text the recipient sees on the deposit. If you leave it out, LEVAPAY is used.
Show the account holder name to the sender before confirming.
Most transfers come back with status completed in the same response.
Amount, fee and total in the quote, with no surprises for your customer.
The required idempotency_key prevents double charges when your system retries.
The same code works for both networks: only the network value changes.
Test the whole flow with TEST keys and no real money.
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:
No. LevaPay is an independent service that lets businesses send money to NatCash wallets through its own API. NatCash is a trademark of Natcom.
Yes. Call GET /wallets/{wallet}?network=natcash or check the beneficiary field in the quote before confirming the transfer.
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.
It is usually credited instantly, and the POST /transfers response already comes back with status completed.
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.
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.
Yes. With the same integration you send to MonCash by setting network to "moncash". MonCash transfers may stay pending for a moment.
Create a free account, test the NatCash API with the test wallet and go live when you are ready.