PAYATHON 2026

已添加Payment Method但Dashboard仍提示Missing

支付小周

结论

在 Business Settings → Payments 中看到银行卡状态为 Active,不代表它已经绑定到实际使用的 WhatsApp Business Account(WABA)。出现该警告通常有两种原因:

  1. 付款方式只添加到了 Meta Business Account,没有分配给对应的 WABA;
  2. WABA 已有有效的付款方式,但 App Dashboard 尚未同步状态,界面仍在显示旧警告。

Development Mode 通常不会导致付款方式失效。要判断付款方式能否使用,应查看对应 WABA 的账单配置和实际 API 请求结果,不能只依据 API Setup 页面上的警告。

先确认付款方式绑定到了正确的 WABA

一个 Business Account 下可能有多个 WhatsApp Business Account。即使付款方式显示为 Active,也不会自动应用到所有 WABA。

进入 Meta Business Settings,找到类似以下路径。具体界面名称可能因账户或地区而略有不同:

Business Settings
└── Accounts
    └── WhatsApp Accounts
        └── 选择 API Setup 中实际使用的 WABA
            └── Settings / Payment Settings

需要核对以下内容:

  • 选中的 WABA ID 是否与 App Dashboard → WhatsApp → API Setup 中显示的 WABA ID 一致;
  • 付款方式是否直接显示在该 WABA 的 Payment Settings 或账单设置中;
  • 付款方式是否已设为默认付款方式;
  • 是否有欠款、付款失败、账户受限或需要补充税务信息的提示;
  • 当前登录用户是否有权管理该 WABA 和财务信息。

如果银行卡只出现在 Business Account 的统一支付页面,还需要执行“分配资产”“设置为 WhatsApp 默认付款方式”或类似操作。仅添加银行卡,不能说明 WABA 已完成计费绑定。

检查 App、WABA 和电话号码是否属于同一组资产

API Setup 页面引用的可能是另一个测试 WABA、旧 WABA,或快速配置流程创建的 WABA。建议记录并交叉核对以下标识:

Business Account ID
App ID
WhatsApp Business Account ID
Phone Number ID

注意区分:

  • WhatsApp Business Account ID:WhatsApp 业务账户;
  • Phone Number ID:调用消息 API 时使用的电话号码资源;
  • Business Account ID:管理这些资产的企业账户。

付款方式必须配置在 Phone Number ID 所属的 WABA 上。配置在另一个同名或旧的 WABA 上不会生效。

用 API 请求判断是否真的被阻止

Dashboard 的警告可能没有及时刷新。最直接的验证方法是使用 API Setup 页面提供的 Phone Number ID 和有效访问令牌,发送一条已获批的模板消息。

curl -X POST \
  "https://graph.facebook.com/vXX.X/<PHONE_NUMBER_ID>/messages" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "<RECIPIENT_PHONE_NUMBER>",
    "type": "template",
    "template": {
      "name": "<APPROVED_TEMPLATE_NAME>",
      "language": {
        "code": "<TEMPLATE_LANGUAGE_CODE>"
      }
    }
  }'

其中:

  • 将 vXX.X 替换为当前应用实际使用且仍受支持的 Graph API 版本;
  • to 应填写包含国家或地区代码的号码,具体格式以当前 Cloud API 要求为准;
  • 模板必须已在该 WABA 中获批;
  • 在 Development Mode 下测试时,接收号码可能需要先加入允许的测试号码列表。

如果请求成功并返回消息 ID,例如:

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<RECIPIENT_PHONE_NUMBER>",
      "wa_id": "<WHATSAPP_ID>"
    }
  ],
  "messages": [
    {
      "id": "<MESSAGE_ID>"
    }
  ]
}

这说明 API 已接受请求。此时 Dashboard 中的 Missing valid payment method 很可能是状态同步延迟或界面缓存导致的。

如果请求失败,请保存完整的错误响应,尤其是以下字段:

{
  "error": {
    "message": "...",
    "type": "...",
    "code": 0,
    "error_subcode": 0,
    "fbtrace_id": "..."
  }
}

排查时应以 code、error_subcode 和 fbtrace_id 为依据。不要仅凭警告文字判断银行卡有问题,因为模板状态、号码注册、权限、访问令牌和账户限制同样可能导致发送失败。

Development Mode 还需要注意什么

Development Mode 和账单状态是两个不同的问题。它不会自动修复或阻止付款方式绑定,但会限制应用可访问的用户和测试资产。

正式使用前还应确认:

  1. WhatsApp 产品已正确添加到 App;
  2. 业务电话号码已经注册并处于可用状态;
  3. 永久访问令牌或 System User token 具备所需权限;
  4. whatsapp_business_messaging 和 whatsapp_business_management 等常见权限已按实际场景配置;
  5. 主动发起对话时使用的是已获批模板;
  6. 应用准备面向非测试用户时,再完成所需的 App Review、权限审批和 Live Mode 切换。

切换到 Live Mode 通常不是消除付款警告的必要条件,也不应将其作为账单问题的修复方法。

如果绑定无误但警告持续存在

确认 WABA、电话号码和付款方式完全匹配后,可以依次尝试:

  1. 在对应 WABA 的支付设置中重新选择默认付款方式;
  2. 检查银行卡是否需要额外验证,以及是否允许线上、跨境或周期性扣款;
  3. 查看 Business Support Home、Account Quality 和 WhatsApp Manager 中是否有账户限制;
  4. 退出后重新进入 App Dashboard,并等待后台账单状态同步;
  5. 实际发送一条模板消息,根据 API 返回结果确认是否可用;
  6. 如果 API 明确返回付款或计费错误,向 Meta Business Support 提交工单。

提交工单时建议附上:

Business Account ID:
App ID:
WhatsApp Business Account ID:
Phone Number ID:
付款方式状态截图:
API 错误 code:
API 错误 error_subcode:
fbtrace_id:
首次出现问题的时间和时区:

不要提交完整银行卡号、CVV 或访问令牌。

注意事项

Meta 的 WhatsApp 计费模式、免费范围和 Dashboard 文案可能随时间及地区变化。页面中有关“免费套餐对话”的说明,未必能准确反映账户当前的计费状态。判断时应结合对应 WABA 的支付设置、WhatsApp Manager 状态和 API 错误响应。

如果付款方式已绑定到正确的 WABA,且模板消息可以通过 API 正常发送,就不必为了清除 Dashboard 警告而反复删除、重新添加银行卡。如果消息请求返回明确的计费错误,应先检查资产绑定关系,再携带 fbtrace_id 联系 Meta 支持处理后台同步问题。

备注:内容仅供参考。