# Error 131042 de WhatsApp: problema con el método de pago — solución

URL: https://wa.genuka.com/es/docs/errors/131042
Language: Spanish

> Error 131042 de WhatsApp: Meta rechaza el envío porque la cuenta de WhatsApp Business no tiene un método de pago válido. Dónde agregar la tarjeta y cómo comprobarlo.

El error 131042 de WhatsApp significa que Meta rechaza el envío por el método de pago de la cuenta
de WhatsApp Business: no hay tarjeta, la línea de crédito superó su límite o la cuenta no está
bien configurada. Meta factura los mensajes directamente al cliente, no a través de Genuka. Agrega
o corrige el método de pago en Meta y vuelve a enviar.

## ¿Qué significa el error 131042?

> "There was an error related to your payment method."
> — [Meta, códigos de error de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

Meta te pide que revises la configuración de facturación y enumera los problemas habituales:

* la cuenta de pago no está vinculada a una cuenta de WhatsApp Business;
* la línea de crédito superó el límite;
* la línea de crédito (cuenta de pago) no está configurada o no está activa;
* la cuenta de WhatsApp Business fue eliminada;
* la cuenta de WhatsApp Business está suspendida;
* la zona horaria no está configurada;
* la moneda no está configurada;
* la solicitud MessagingFor (On Behalf Of) está pendiente o fue rechazada.

El título que acompaña al código en el campo `message` es "Business eligibility payment issue"
([lista de 360dialog](https://docs.360dialog.com/docs/support/api-error-message-list)).

### ¿Por qué no basta con mi suscripción a Genuka WA?

Porque Genuka es un **Meta Tech Provider**, no un Business Solution Provider (BSP). Cada cliente
conecta su propia cuenta de WhatsApp Business, y **Meta factura los mensajes directamente a esa
cuenta**, sin recargo de Genuka. La suscripción a Genuka WA paga la plataforma, no los mensajes:
no reemplaza la tarjeta que Meta espera en el portafolio comercial del cliente.

Lo que vemos en la práctica: una cuenta sin método de pago puede crear plantillas y lograr que se
aprueben, pero cada envío vuelve con 131042. Y no podemos comprobarlo por adelantado, porque Meta
solo comparte los datos de financiación de una cuenta con los BSP.

## ¿Cuándo aparece el error 131042?

* **En el primer envío de plantilla** de una cuenta recién conectada, cuando nadie ha agregado
  todavía una tarjeta en Meta.
* **Cuando una tarjeta vence o es rechazada** en una cuenta que antes enviaba.
* **En medio de una campaña**: todos los destinatarios fallan por el mismo motivo.

### ¿Dónde lo ves en Genuka WA?

| Canal                                                             | Qué recibes                                                                                                                              |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Respuesta de `POST /api/v1/messages`                              | Un rechazo cuyo `meta.code` es `131042`, con el texto de Meta en `message`                                                               |
| Webhook `message_status`, cuando Meta informa el fallo después    | `data.status: "failed"`, `data.errors[0].code: 131042`                                                                                   |
| Campaña                                                           | Todos los destinatarios pasan a `failed`. Cuando Meta rechaza durante la llamada, el incidente también se señala una vez para la campaña |
| Panel, página del cliente, cuando Meta rechaza durante la llamada | El aviso "Meta rechaza los envíos de este número", con el mensaje de Meta y un botón "Agregar una tarjeta en Meta"                       |
| WhatsApp, cuando Meta rechaza durante la llamada                  | Una alerta al socio, como máximo una vez por semana por número                                                                           |

Meta indica que sus errores vuelven en la respuesta, por webhook o de ambas formas
([Meta, códigos de error](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)).
Genuka WA solo muestra el aviso y envía la alerta por WhatsApp ante un rechazo recibido **durante
la llamada**: un 131042 que solo llega por el webhook `message_status` deja el mensaje en
`failed`, sin aviso ni alerta. Así que vigila también el webhook.

## ¿Cómo corrijo el error 131042?

1. **Abre la configuración de pago de la cuenta en Meta.** Desde la página del cliente en el panel,
   el botón "Agregar una tarjeta en Meta" abre directamente la página de la cuenta de WhatsApp en la
   configuración comercial de Meta, o el centro de facturación cuando no se conoce el ID del
   portafolio. Quien debe actuar es el propietario de la cuenta, el cliente: la tarjeta es suya.
2. **Agrega o reemplaza el método de pago** y luego revisa las demás causas de la lista de Meta: zona
   horaria y moneda configuradas, cuenta ni suspendida ni eliminada.
3. **Confírmalo en Genuka WA** con "Ya hay una tarjeta registrada". No podemos comprobarlo nosotros
   mismos: el aviso vuelve solo si Meta rechaza otro envío durante la llamada por el mismo motivo.
4. **Prueba con un solo mensaje** antes de relanzar una campaña: un envío aceptado y luego entregado
   confirma que el bloqueo desapareció.

**Node.js**

```ts
const response = await fetch("https://wa.genuka.com/api/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    connectionId: "con_1",
    to: "+237690000001",
    template: { name: "order_update", language: "en", body: ["Awa", "ORD-1042"] },
  }),
});
const json = await response.json();

if (!response.ok && json.meta?.code === 131042) {
  // Nada que reintentar: el cliente debe agregar una tarjeta a su cuenta de Meta.
  await notifyAccountOwner(json.meta.details ?? json.message); // tu función
}

// En tu ruta de webhook, una vez verificada la firma: el mismo rechazo puede llegar después.
export async function onMessageStatus(event: {
  type: string;
  data: { status: string; errors?: { code: number; message?: string }[] };
}) {
  if (event.type !== "message_status" || event.data.status !== "failed") return;
  const error = event.data.errors?.find((e) => e.code === 131042);
  if (error) await notifyAccountOwner(error.message ?? "131042");
}
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://wa.genuka.com/api/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}",
        "User-Agent": "acme-crm/1.0 (+https://example.com)",
    },
    json={
        "connectionId": "con_1",
        "to": "+237690000001",
        "template": {"name": "order_update", "language": "en", "body": ["Awa", "ORD-1042"]},
    },
    timeout=30,
)
body = response.json()
if not response.ok and body.get("meta", {}).get("code") == 131042:
    # Nada que reintentar: el cliente debe agregar una tarjeta a su cuenta de Meta.
    notify_account_owner(body["meta"].get("details") or body.get("message"))  # tu función


# En tu ruta de webhook, una vez verificada la firma: el mismo rechazo puede llegar después.
def on_message_status(event: dict) -> None:
    data = event.get("data", {})
    if event.get("type") != "message_status" or data.get("status") != "failed":
        return
    for error in data.get("errors", []):
        if error.get("code") == 131042:
            notify_account_owner(error.get("message") or "131042")
            return
```

## ¿Cómo evito el error 131042?

* **Haz que se agregue la tarjeta durante la incorporación**, antes de la primera plantilla. El
  panel muestra el aviso "Agregar un método de pago en Meta" en cada número hasta que se confirme.
* **Explica las dos facturas a tus clientes desde el principio**: por un lado la suscripción a
  Genuka WA, por el otro los mensajes facturados por Meta.
* **No lances una campaña grande en una cuenta que nunca ha enviado**: un solo mensaje de prueba
  revela el problema por el precio de un mensaje.

## Códigos de error relacionados

* [131048](https://wa.genuka.com/es/docs/errors/131048): otro motivo por el que Meta rechaza los envíos de un número,
  ligado a la calidad y no al pago.
* [132001](https://wa.genuka.com/es/docs/errors/132001): un rechazo relacionado con la propia plantilla, que a veces se
  confunde con un bloqueo de la cuenta.

Para la suscripción a Genuka WA en sí, consulta [Planes y facturación](https://wa.genuka.com/es/docs/billing).

## Preguntas frecuentes

### ¿Mi suscripción a Genuka WA cubre los mensajes de WhatsApp?

No. Genuka cobra una suscripción por número de WhatsApp; los mensajes los factura Meta,
directamente a la cuenta de WhatsApp Business del cliente, sin recargo de Genuka. Consulta los
[planes](https://wa.genuka.com/es#pricing).

### ¿Por qué Genuka WA no puede detectar la falta de tarjeta antes de enviar?

Porque Meta solo comparte los datos de financiación de una cuenta de WhatsApp Business con los
BSP. Como Genuka es un Tech Provider, la primera señal fiable es el propio rechazo 131042.

### ¿Quién debe agregar la tarjeta?

La empresa propietaria de la cuenta de WhatsApp Business, en su propio portafolio comercial de
Meta. Un socio que gestiona varios clientes no puede pagar en su nombre a través de Genuka WA.

## Fuentes

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [360dialog — API error message list](https://docs.360dialog.com/docs/support/api-error-message-list)
