Genuka WA docs

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

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

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).

¿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?

CanalQué recibes
Respuesta de POST /api/v1/messagesUn rechazo cuyo meta.code es 131042, con el texto de Meta en message
Webhook message_status, cuando Meta informa el fallo despuésdata.status: "failed", data.errors[0].code: 131042
CampañaTodos 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 llamadaEl 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 llamadaUna 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). 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?

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.

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.

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.

Prueba con un solo mensaje antes de relanzar una campaña: un envío aceptado y luego entregado confirma que el bloqueo desapareció.

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");
}

¿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: otro motivo por el que Meta rechaza los envíos de un número, ligado a la calidad y no al pago.
  • 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.

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.

¿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

En esta página