Erreur WhatsApp 131042 : problème de moyen de paiement
Erreur WhatsApp 131042 : Meta refuse l'envoi faute de moyen de paiement valide sur le compte WhatsApp Business. Où ajouter la carte et comment vérifier.
L'erreur WhatsApp 131042 signifie que Meta refuse l'envoi à cause du moyen de paiement du compte WhatsApp Business : aucune carte, une ligne de crédit dépassée, ou un compte mal configuré. Meta facture les messages directement au client, pas via Genuka. Ajoutez ou corrigez le moyen de paiement chez Meta, puis renvoyez.
Que signifie l'erreur 131042 ?
« There was an error related to your payment method. » — Meta, codes d'erreur de la Cloud API
Meta demande de vérifier la configuration de la facturation et liste les causes courantes :
- aucun compte de paiement n'est rattaché au compte WhatsApp Business ;
- la ligne de crédit a dépassé sa limite ;
- la ligne de crédit (compte de paiement) n'est pas définie ou pas active ;
- le compte WhatsApp Business est supprimé ;
- le compte WhatsApp Business est suspendu ;
- le fuseau horaire n'est pas défini ;
- la devise n'est pas définie ;
- la demande « MessagingFor » (On Behalf Of) est en attente ou refusée.
Le titre associé au code dans le champ message est « Business eligibility payment issue »
(liste de 360dialog).
Pourquoi mon abonnement Genuka WA ne suffit-il pas ?
Parce que Genuka est Meta Tech Provider, pas fournisseur de solutions (BSP). Chaque client connecte son propre compte WhatsApp Business, et Meta facture les messages directement sur ce compte, sans marge de Genuka. L'abonnement Genuka WA paie la plateforme, pas les messages : il ne remplace pas la carte que Meta attend sur le portefeuille d'entreprise du client.
Ce que nous observons en pratique : un compte sans moyen de paiement peut créer des templates et les faire approuver, mais chaque envoi revient en 131042. Et nous ne pouvons pas le vérifier à l'avance, car Meta ne communique les informations de financement d'un compte qu'aux BSP.
Quand l'erreur 131042 apparaît-elle ?
- Au premier envoi de template d'un compte tout juste connecté, quand personne n'a encore ajouté de carte chez Meta.
- Quand une carte expire ou est refusée sur un compte qui envoyait jusque-là.
- En pleine campagne : tous les destinataires échouent pour la même raison.
Où la voir dans Genuka WA ?
| Canal | Ce que vous recevez |
|---|---|
Réponse de POST /api/v1/messages | Un refus dont meta.code vaut 131042, avec le texte de Meta dans message |
Webhook message_status, si Meta signale l'échec après coup | data.status: "failed", data.errors[0].code: 131042 |
| Campagne | Tous les destinataires passent failed. Quand Meta refuse dès l'appel, l'incident est en plus signalé une seule fois pour la campagne |
| Tableau de bord, fiche du client, quand Meta refuse dès l'appel | L'encadré « Meta refuse les envois sur ce numéro », avec le message de Meta et un bouton « Ajouter une carte chez Meta » |
| WhatsApp, quand Meta refuse dès l'appel | Une alerte au partenaire, au plus une fois par semaine et par numéro |
Meta indique que ses erreurs arrivent dans la réponse, par webhook, ou les deux
(Meta, codes d'erreur).
Genuka WA ne déclenche l'encadré et l'alerte WhatsApp que sur un refus reçu dès l'appel : un
131042 qui n'arrive que par le webhook message_status passe le message en failed, sans encadré
ni alerte. Surveillez donc aussi le webhook.
Comment corriger l'erreur 131042 ?
Ouvrez les paramètres de paiement du compte chez Meta. Depuis la fiche du client dans le tableau de bord, le bouton « Ajouter une carte chez Meta » ouvre directement la page du compte WhatsApp dans les paramètres de l'entreprise Meta, ou le centre de facturation quand l'identifiant du portefeuille est inconnu. C'est le propriétaire du compte, le client, qui doit agir : la carte est la sienne.
Ajoutez ou remplacez le moyen de paiement, puis vérifiez les autres causes de la liste de Meta : fuseau horaire et devise définis, compte ni suspendu ni supprimé.
Confirmez-le dans Genuka WA avec « Une carte est déjà enregistrée ». Nous ne pouvons pas le contrôler nous-mêmes : l'encadré revient de lui-même si Meta refuse dès l'appel un nouvel envoi pour la même raison.
Testez avec un seul message avant de relancer une campagne : un envoi accepté puis livré confirme que le blocage est levé.
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: "suivi_commande", language: "fr", body: ["Awa", "CMD-1042"] },
}),
});
const json = await response.json();
if (!response.ok && json.meta?.code === 131042) {
// Rien à réessayer : le client doit ajouter une carte sur son compte Meta.
await notifyAccountOwner(json.meta.details ?? json.message); // votre fonction
}
// Dans votre route webhook, une fois la signature vérifiée : le même refus peut arriver après coup.
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");
}Comment éviter l'erreur 131042 ?
- Faites ajouter la carte pendant la mise en route, avant le premier template. Le tableau de bord affiche l'encadré « Ajoutez un moyen de paiement chez Meta » sur chaque numéro tant que ce n'est pas confirmé.
- Expliquez la double facturation à vos clients dès le départ : l'abonnement Genuka WA d'un côté, les messages facturés par Meta de l'autre.
- Ne lancez pas une grosse campagne sur un compte qui n'a jamais envoyé : un seul message de test révèle le problème pour le prix d'un message.
Quels codes sont liés ?
- 131048 : une autre raison pour laquelle Meta refuse les envois d'un numéro, liée à la qualité et non au paiement.
- 132001 : un refus lié au template lui-même, que l'on confond parfois avec un blocage du compte.
Pour la facturation de l'abonnement Genuka WA, voir Forfaits et facturation.
FAQ
Mon abonnement Genuka WA couvre-t-il les messages WhatsApp ?
Non. Genuka facture un abonnement par numéro WhatsApp ; les messages sont facturés par Meta, directement sur le compte WhatsApp Business du client, sans marge de Genuka. Voir les formules.
Pourquoi Genuka WA ne détecte-t-il pas l'absence de carte avant l'envoi ?
Parce que Meta ne communique les informations de financement d'un compte WhatsApp Business qu'aux BSP. Genuka étant Tech Provider, le premier signal fiable est le refus 131042 lui-même.
Qui doit ajouter la carte ?
L'entreprise propriétaire du compte WhatsApp Business, dans son propre portefeuille Meta Business. Un partenaire qui gère plusieurs clients ne peut pas payer à leur place via Genuka WA.