⚡Quick answer-

Pricing appears only in the message-status webhook, inside statuses[*].pricing. It is added after the message is delivered and represents the final, billable conversation charge.

When should I use this guide?

Refer to these steps when you need to pull reliable cost data from WhatsApp Cloud API or On-Premises API webhooks for analytics, invoicing, or spend alerts.

1. Overview

This information outlines the system behaviour regarding billing for WhatsApp Business API (WABA) campaigns, direct chat, and API messaging. It defines how the system handles insufficient balances and where billing data is accessible.

2. Billing Conditions & System Behaviour

Condition I: Campaign Execution (Insufficient Balance)

When a client attempts to launch a broadcast campaign without the required funds:

• System Action: The system calculates the estimated cost based on the target audience size.
• User Interface: An approximate amount will be displayed in red, notifying the client that they have insufficient funds to proceed.
• Result: The campaign will be blocked from starting until the wallet is recharged.
  

Alt text: Campaign execution

Condition II: Manual Chat Messaging (Low Balance)

When a client attempts to send a manual message through the chat interface while the account balance is low:

• System Action: The system performs a real-time balance check.
• Error Message: A notification stating "Insufficient balance" will appear.
• Result: The message will not be dispatched to the recipient.
  
  
  Alt text: manual chat messaging (low balance)
  

Condition III: API-based messaging (Low Balance)

When a message is triggered via API and the account does not meet the minimum balance threshold, the system will return a 400-series error.

Error Response Example:

{

    "status": "error",

    "code": "CHAT_4001",

    "message": "Low balance for chat",

    "errors": {

        "detail": "Insufficient balance for WhatsApp"

    }

}

Pre-Campaign Estimates

• Approximate Costing: Clients can view the Approximate Cost before finalising and running a campaign. It is highly recommended that clients check this estimate to ensure their balance covers the intended reach.

3. Post-Campaign Auditing

• Account Manager (AM) Access: Once a campaign is completed, Account Managers can verify the transactions in the Accounts Panel under the Credit History section.
• Client View: Clients cannot view specific billing deductions for a campaign once it has been completed within their standard dashboard view.

4. Limitations:

• Direct/API Messages: For individual messages sent via Chat or API, the specific deducted amount per message is not visible in the UI.
• Monthly Statements: Detailed per-message or per-campaign billing breakdowns are not available in the generated monthly statements.

Check WABA billing settings; webhook mirrors that value.

Keywords: WhatsApp pricing webhook, statuses.pricing, CBP, conversation-based pricing, Cloud API, On-Premises