API

Guides / Going live

Going live

Production keys move real money, so they are issued to reviewed accounts only. Finish your integration in the sandbox, then email us. This page lists what to send.

Before you apply

Your integration should pass every step of the sandbox test plan, driven by your own code:

Also confirm that:

The email

Send it to [email protected] from the address that should receive the key. Copy this and fill it in:

Subject: Production access: [business name]

Business
- Registered name:
- Trading name (if different):
- Country and city:
- Website or shop location:
- Contact person and phone number:

Integration
- What you are building (for example: POS for 12 shops, wallet, marketplace):
- Who pays (your customers, walk-in customers):
- Whose Lightning address receives the sats (yours, or each customer's):
- Expected typical order (KES):
- Expected volume per day (KES):

Sandbox evidence
- Sandbox account ID (ptr_...):
- Completed order ID:
- Payment failed order ID:
- Needs review order ID:
- Pay Bill order ID:
- A delivered webhook event ID (evt_...):

Production
- Webhook URL:
- Technical contact email for the key link:

What happens next

  1. We check your sandbox orders and webhooks. We can see the order and event IDs you send, and whether your endpoint accepted the deliveries.
  2. We may ask questions about your business, your customers or how your screens handle failures. Sometimes we ask for a short call or screenshots.
  3. We create your production account with limits that suit your volume, up to KES 5,000 per order and KES 50,000 per 24 hours.
  4. We email your technical contact a one-time link. Open it, press Reveal key and copy the vk_live_ key into your secret store. The link expires after 72 hours. See how production keys are delivered.
  5. Register your webhook in production. Webhook settings do not carry over from the sandbox. Call POST /v1/webhook on api.vukia.app with your live key and store the new secret.
  6. Make one small real order, for example KES 50 to a Lightning address you control. Check that the sats arrive and your system marks the sale paid. Then open to customers.

Switching your code to production

SettingSandboxProduction
Base URLhttps://sandbox.vukia.app/v1https://api.vukia.app/v1
API keyvk_test_…vk_live_…
Webhook secretFrom sandbox POST /v1/webhookFrom production POST /v1/webhook
Test phone numbersWorkNot special. Do not use them in production.

Keep the base URL, key and webhook secret together in configuration, so one switch moves all three.

Scope at launch

Production accounts can buy: collect shillings with M-Pesa and deliver sats to a Lightning address. Selling sats for M-Pesa shillings is not available through the API.

Your responsibilities