DEVELOPER FIRST INTEGRATION
Simple Integration Code for Developers & Merchants
Plug NAWERI WALLET into any HTML website, PHP backend, or cURL API endpoint in minutes.
HTML Merchant Checkout Form
Direct Form Post
<form action="https://wallet.naweriindustries.com/endpoints/payment-endpoint.php" method="post">
<input type="hidden" name="customerName" value="John Doe">
<input type="hidden" name="customerPhone" value="+256772000000">
<input type="hidden" name="customerEmail" value="john@example.com">
<input type="hidden" name="itemId" value="INV-1029">
<input type="hidden" name="orderCurrency" value="UGX">
<input type="hidden" name="merchantKey" value="NW_LIVE_KEY_891283">
<input type="hidden" name="customerAddress" value="Kampala, Uganda">
<input type="hidden" name="itemName" value="Invoice Payment">
<input type="hidden" name="orderDate" value="2026-07-31">
<input type="hidden" name="orderReference" value="REF-NW-998">
<input type="hidden" name="successUrl" value="https://mybiz.ug/success">
<input type="hidden" name="failedUrl" value="https://mybiz.ug/failed">
<div class="row">
<div>
<label class="label">Customer</label>
<input class="input" readonly value="John Doe">
</div>
<div>
<label class="label">Phone</label>
<input class="input" readonly value="+256772000000">
</div>
</div>
<br>
<label class="label">Invoice Quantity</label>
<input class="input" type="number" readonly value="1">
<br><br>
<label class="label">Total Payable</label>
<input class="input" id="payAmount" value="150000">
<input type="hidden" name="totalPrice" value="150000">
<div class="summary">
<div>
<h4>Outstanding Balance</h4>
<div class="small">Auto-calculated from invoice</div>
</div>
<strong>UGX 150,000</strong>
</div>
<label class="label">Description</label>
<textarea class="input" rows="3" readonly>Payment for invoice #INV-1029</textarea>
<br><br>
<button class="btn" name="intNaweri">
Finalize & Pay Securely
</button>
</form>
PHP cURL STK Push Request
Server-Side Request
<?php
// Initialize NAWERI WALLET Payment Request
$curl = curl_init();
$payload = json_encode([
"merchantKey" => "NW_LIVE_KEY_891283",
"customerPhone" => "+256772000000",
"totalPrice" => 150000,
"orderCurrency" => "UGX",
"orderReference"=> "ORD-UG-991",
"callbackUrl" => "https://mybiz.ug/api/callback"
]);
curl_setopt_array($curl, [
CURLOPT_URL => "https://wallet.naweriindustries.com/endpoints/payment-endpoint.php",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer nw_live_sk_891283...",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
cURL Command Payload
HTTP REST API
curl -X POST https://wallet.naweriindustries.com/endpoints/payment-endpoint.php \
-H "Authorization: Bearer nw_live_sk_891283..." \
-H "Content-Type: application/json" \
-d '{
"merchantKey": "NW_LIVE_KEY_891283",
"customerPhone": "+256772000000",
"totalPrice": 150000,
"orderCurrency": "UGX",
"orderReference": "ORD-UG-991",
"callbackUrl": "https://mybiz.ug/api/callback"
}'
API Endpoint: wallet.naweriindustries.com
Get Merchant API Key →
