WhatsApp Business Platform

Send WhatsApp messages as your business

HavenPay is a Meta-registered WhatsApp BSP. We provision your WhatsApp Business Account, handle Meta registration end-to-end, and give you a clean REST API for templated messages, bulk broadcasts, and 24-hour service replies โ€” at transparent KES per-message pricing.

Two ways to connect your WABA

New to WhatsApp Business? Let us handle everything. Already have a Meta WABA? Bring your own credentials and go live instantly.

HavenPay-managed

We handle everything

Submit your business details and we register the WABA, phone number, and display name with Meta on your behalf. No Meta Business Manager account needed.

01
You submit
Display name, phone number, category, description. 2 minutes.
02
HavenPay reviews
Internal policy check โ€” typically within 1 business day.
03
We register with Meta
WABA + phone number created in Meta Business Manager.
04
Meta confirms
Display name review. 1โ€“5 business days. We keep you updated.
05
You go live
WABA marked ACTIVE. Send templates and service messages now.
Typical: 1โ€“7 business days
Self-managed (self_managed: true)

Bring your own WABA

Already registered a WABA and phone number directly with Meta? Supply your own Cloud API credentials and HavenPay activates your account immediately โ€” no admin review, no waiting.

Required credentials
meta_waba_id
WABA ID from Meta Business Manager
meta_phone_number_id
Phone Number ID from Meta
access_token
Permanent System User access token scoped to the WABA
Messages sent via your own Cloud API token
Credentials stored encrypted at rest
Update credentials at any time via PATCH

Transparent per-message pricing

Billed per message by category โ€” exactly how Meta's 2025 model works. Service replies are always free. Custom pricing available for high-volume merchants.

Marketing

Promotions, campaigns, re-engagement

KES 4.00 / msg

Utility

Order updates, invoices, OTP โ€” triggered by customer action

KES 1.50 / msg

Authentication

One-time passwords and verification codes

KES 1.50 / msg

Service

Reply within 24-hour customer service window

FREE

Prices in KES. Platform default โ€” merchant-specific pricing may apply. Service messages are always KES 0.00.

Everything you need to send at scale

From single messages to 5,000-recipient broadcasts โ€” with full delivery tracking, webhook receipts, and scheduled campaigns.

Verified Business Profile

Your business appears with a verified green tick โ€” customers recognise a legitimate sender before reading a word.

Template & Free-form Messages

Pre-approved templates for outbound sends. Free-form replies inside the 24-hour service window at no extra charge.

Full Delivery Lifecycle

Every message moves through queued โ†’ sent โ†’ delivered โ†’ read (or failed). Timestamps for each transition stored per message.

Bulk Broadcast โ€” up to 5,000

Send one template to up to 5,000 recipients in a single API call. Each is dispatched individually for privacy โ€” no group leakage.

Multi-gateway Routing

Messages are routed through Meta Cloud API, 360dialog, Infobip, or Twilio โ€” with configurable priority failover between gateways.

Clean REST API

Endpoints for send, bulk-send, template-send, message log, stats, and pricing. Bearer token auth with per-merchant rate limiting.

Signed Webhooks

Meta delivery receipts are verified with X-Hub-Signature-256 before processing โ€” no spoofed status updates.

Live Stats Dashboard

Today / 7-day / all-time counts broken down by status and category. Total spend in KES included per period.

Scheduled & Recurring Sends

Use comm schedules to fire WhatsApp campaigns on a cron or one-time basis โ€” invoices, reminders, renewal notices.

Full message status lifecycle

Every message is tracked through six states. Delivered and read timestamps are recorded from Meta webhook receipts, verified with X-Hub-Signature-256.

queued
sent
delivered
read
failed
rejected
sent_at
When HavenPay dispatched to gateway
delivered_at
Timestamp from Meta delivery receipt
read_at
Timestamp from Meta read receipt

Template management & Meta approval

Build templates with headers, body copy, footers, and action buttons. Submit to Meta for approval and manage the full lifecycle from your dashboard or API.

Template structure
Header
text ยท image ยท document
Body
required ยท {{variable}} params
Footer
optional ยท plain text ยท 60 chars
Buttons
quick_reply ยท URL ยท phone ยท up to 3
Valid categories
utility ยท marketing ยท authentication
Languages: en ยท en_US ยท sw ยท fr ยท ar ยท es
Approval lifecycle
draft
Not yet submitted to Meta
pending
Submitted โ€” awaiting Meta approval
approved
Ready to use in outbound sends
rejected
Meta refused โ€” reason stored
paused
Meta paused due to low quality
disabled
Permanently blocked by Meta
Only APPROVED templates may be used for outbound sends. Draft and rejected templates can be edited and re-submitted. Meta may pause or disable templates based on quality scores.

Multi-gateway routing

HavenPay connects to four upstream gateways with configurable priority ordering. Routes with higher priority are tried first; failover is automatic.

Meta Cloud API
Recommended

Official Meta gateway โ€” no infrastructure to manage

360dialog
Africa-popular

Meta BSP reseller โ€” widely used across African markets

Infobip
Enterprise

Global CPaaS with dedicated WhatsApp infrastructure

Twilio
Global

Twilio Conversations API WhatsApp channel

Gateway credentials are encrypted at rest using AES encryption
Managed Registration Timeline

1โ€“7 business days to go live

Meta's review time depends on your business category and display name. We handle all communication with Meta and keep you updated at every status change.

Self-managed mode: activated instantly โ€” no waiting.
1
Internal review
1 business day
2
Meta WABA creation
1โ€“2 days
3
Meta display name review
1โ€“5 days

Supported business categories

Meta requires a business category at WABA registration. All 20 Meta-supported categories are accepted.

ADVERTISINGAGRICULTUREAUTOMOTIVEBEAUTYCLOTHINGEDUCATIONENTERTAINMENTFINANCIAL_SERVICESFOOD_AND_GROCERYGOVERNMENTHEALTHHOME_IMPROVEMENTHOTELNGOPROFESSIONAL_SERVICESRETAILTECHNOLOGYTRANSPORTATIONTRAVELOTHER

REST API reference

All endpoints require a Bearer token. Responses are JSON. Base URL: https://api.havenpay.site

Method
Path
Description
GET
/v1/csp/whatsapp/waba/
List your WABA accounts
POST
/v1/csp/whatsapp/waba/
Submit new WABA request (managed or self-managed)
GET
/v1/csp/whatsapp/waba/:id/
Get WABA status & details
DELETE
/v1/csp/whatsapp/waba/:id/
Cancel a pending request
PATCH
/v1/csp/whatsapp/waba/:id/credentials
Update self-managed credentials
POST
/v1/csp/whatsapp/send
Send a single free-form or template message
POST
/v1/csp/whatsapp/send-template
Convenience alias for template sends
POST
/v1/csp/whatsapp/send-bulk
Broadcast to up to 5,000 recipients
GET
/v1/csp/whatsapp/messages/
Paginated message log (filter by status / category / batch)
GET
/v1/csp/whatsapp/messages/:id/
Single message detail + timestamps
GET
/v1/csp/whatsapp/stats/
Today / 7-day / all-time delivery stats
GET
/v1/csp/whatsapp/pricing/
Your per-category pricing (KES)
GET
/v1/csp/whatsapp/templates/
List message templates
POST
/v1/csp/whatsapp/templates/
Create a new template
POST
/v1/csp/whatsapp/templates/:id/submit
Submit draft template to Meta for approval
POST
/v1/csp/whatsapp/templates/:id/sync
Pull latest approval status from Meta

Start sending WhatsApp messages as your brand

Submit your WABA request and go live in days โ€” or bring your own credentials and start immediately.