WhatsApp Cloud API · error code

WhatsApp error 131042: Business eligibility payment issue

ConfigurationHTTP 400Account integrity & policy

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
There was an error related to your payment method.

What error 131042 means

Code 131042 means the send was blocked because of a billing problem on the WhatsApp Business Account. Since billing is per delivered template message, Meta needs a working payment setup before it will deliver paid messages, and when that setup is missing or broken the API refuses with 131042. Meta's documentation lists the common problems explicitly: no payment account attached to the WABA, a credit line over its limit or not active, a deleted or suspended WABA, timezone or currency not set, a pending or declined on-behalf-of (MessagingFor) request, and exceeding any free threshold without a valid payment method.

It usually appears the first time a new WABA tries to send a template to a real customer, because the test number phase never required billing. It can also appear suddenly on a mature account when a card expires or a credit line is paused.

Your message, template, and recipient are fine. This is resolved in Business Manager, not in code.

Why it happens

  • No payment method or credit line attached to the WhatsApp Business Account.
  • Credit line over limit, inactive, or a card that expired or was declined.
  • Timezone or currency never set on the WABA, which blocks billing from being established.
  • A partner MessagingFor (On Behalf Of) request still pending or declined.
  • The WABA was deleted or suspended.

How to fix WhatsApp error 131042

  1. 1Open WhatsApp Manager, Account Tools, Payment Settings and confirm a valid payment method is attached.
  2. 2Set the WABA's timezone and currency if they are blank.
  3. 3If a partner bills on your behalf, check the MessagingFor request status and approve or resolve it.
  4. 4Clear any outstanding balance or raise the credit line limit.
  5. 5Retry the send; billing changes take effect quickly once the account is in good standing.

How to stop it recurring

Make billing setup part of your go-live checklist, ahead of the first production template send, and subscribe to account_update webhooks so payment or status problems reach your team before customers notice. For partner-managed accounts, document who owns billing so a declined MessagingFor request is not discovered through 131042. Billing setup is also the moment to estimate real message costs with the WhatsApp API cost calculator; pricing categories are summarized in the limits reference. If the account itself is restricted rather than unbilled, see 368.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 131042 - quick answers

What does WhatsApp error 131042 mean?

Code 131042 means the send was blocked because of a billing problem on the WhatsApp Business Account. Since billing is per delivered template message, Meta needs a working payment setup before it will deliver paid messages, and when that setup is missing or broken the API refuses with 131042.

How do I fix WhatsApp error 131042?

1. Open WhatsApp Manager, Account Tools, Payment Settings and confirm a valid payment method is attached. 2. Set the WABA's timezone and currency if they are blank. 3. If a partner bills on your behalf, check the MessagingFor request status and approve or resolve it. 4. Clear any outstanding balance or raise the credit line limit. 5. Retry the send; billing changes take effect quickly once the account is in good standing.

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.