Home Developer Playground Link Generator Dashboard Pay Now →
For Developers

Payment Playground

Enter your payment gateway credentials — Paybill or Till — and trigger a live payment prompt to any mobile number. Test instantly without deploying anything.

Your Gateway Credentials
Entered in-browser only — never stored or logged
Sandbox / Prod
Your .env content is parsed locally in your browser. Nothing is sent to any server until you click Send.
Use Server-Side Credentials
Credentials are loaded from your Vercel environment variables. No need to enter them here — just fill in the payment details below and send.
Payment Details
API Endpoint

Make a POST request to trigger a payment prompt from your own backend or frontend:

POST /api/stkpush
Request Body (JSON)
{
 "phone": "0712345678",
 "amount": 100,
 "account": "Invoice-001",
 "consumerKey": "...",
 "consumerSecret": "...",
 "passkey": "...",
 "shortcode": "174379",
 "callbackUrl": "https://..."
}
Credentials in the request body override server env vars. Omit them to use the server-side keys.
Get Your Gateway Keys
1
Create Gateway Account
Contact your payment provider and sign up for a developer account.
2
Create an App
Go to your developer portal → Create a new app → enable sandbox access.
3
Copy your keys
Open the app → copy Consumer Key and Consumer Secret. The sandbox Shortcode is 174379 and passkey is in the docs.
4
Set Callback URL
Use webhook.site for quick sandbox testing, or your own /api/callback endpoint.
5
Go Live
Apply for production access → update the API endpoint in the server configuration.
.env Template

Copy this to your Vercel Environment Variables:

CONSUMER_KEY=your_key_here
CONSUMER_SECRET=your_secret_here
PASSKEY=your_passkey_here
SHORTCODE=174379
CALLBACK_URL=https://your-app.vercel.app/api/callback
SUPABASE_URL=https://xxx.supabase.co
SUPABASE_SERVICE_KEY=your_service_key
DASHBOARD_KEY=your_dashboard_password