Developer Portal & Sandbox
PrintPay B2C API Suite
Test live cURL endpoints securely using X-Wallet-ID & X-Security-Credential headers.
API Authentication Credentials (No Session Required)
1. Check Wallet Balance
POST
JSON Output
Ready to test...
Raw Response
Waiting...
Retrieves live B2C wallet balance securely using API headers.
curl -X POST "https://printpay.co.ke.helapull.com/b2c/walletbalance" \ -H "X-Wallet-ID: WALLET_XYZ123" \ -H "X-Security-Credential: your_api_key"
2. Wallet Top-Up (STK Push)
POST
JSON Output
Ready to test...
Raw Response
Waiting...
Initiates STK Push deposit using API headers.
curl -X POST "https://printpay.co.ke.helapull.com/b2c/topup/stk_push" \
-H "X-Wallet-ID: WALLET_XYZ123" \
-H "X-Security-Credential: your_api_key" \
-H "Content-Type: application/json" \
-d '{"phone": "0712345678", "amount": 500}'
3. Check Top-Up Status
GET
JSON Output
Ready to test...
Raw Response
Waiting...
Polls top-up transaction status using API credentials.
curl -X GET "https://printpay.co.ke.helapull.com/b2c/topup/check_status.php?checkout_id=ws_CO_..." \ -H "X-Wallet-ID: WALLET_XYZ123" \ -H "X-Security-Credential: your_api_key"
4. B2C Disbursement Payout
POST
JSON Output
Ready to test...
Raw Response
Waiting...
Sends disbursement headlessly via cURL using API headers (No PIN required).
curl -X POST "https://printpay.co.ke.helapull.com/b2c/payout/withdraw" \
-H "X-Wallet-ID: WALLET_XYZ123" \
-H "X-Security-Credential: your_api_key" \
-H "Content-Type: application/json" \
-d '{"command_id": "BusinessPayment", "phone": "0712345678", "amount": 1000}'
5. Check Payout Status
POST
JSON Output
Ready to test...
Raw Response
Waiting...
Polls status of processing disbursement using API credentials.
curl -X POST "https://printpay.co.ke.helapull.com/b2c/payout/status" \
-H "X-Wallet-ID: WALLET_XYZ123" \
-H "X-Security-Credential: your_api_key" \
-H "Content-Type: application/json" \
-d '{"conversation_id": "Ag_20261023_..."}'