Errore WhatsApp 131042: problema con il metodo di pagamento — soluzione
Errore WhatsApp 131042: Meta rifiuta l'invio perché il WhatsApp Business Account non ha un metodo di pagamento valido. Dove aggiungere la carta e come verificarla.
L'errore WhatsApp 131042 significa che Meta rifiuta l'invio a causa del metodo di pagamento del WhatsApp Business Account: nessuna carta, una linea di credito oltre il limite, oppure un account non configurato correttamente. Meta fattura i messaggi direttamente al cliente, non tramite Genuka. Aggiungi o correggi il metodo di pagamento presso Meta, poi invia di nuovo.
Cosa significa l'errore 131042?
"There was an error related to your payment method." — Meta, Cloud API error codes
Meta ti chiede di verificare la configurazione della fatturazione ed elenca i problemi più comuni:
- l'account di pagamento non è collegato a un WhatsApp Business Account;
- la linea di credito ha superato il limite;
- la linea di credito (account di pagamento) non è impostata o non è attiva;
- il WhatsApp Business Account è stato eliminato;
- il WhatsApp Business Account è sospeso;
- il fuso orario non è impostato;
- la valuta non è impostata;
- la richiesta MessagingFor (On Behalf Of) è in attesa o è stata rifiutata.
Il titolo che accompagna il codice nel campo message è "Business eligibility payment issue"
(elenco di 360dialog).
Perché il mio abbonamento Genuka WA non basta?
Perché Genuka è un Meta Tech Provider, non un Business Solution Provider (BSP). Ogni cliente collega il proprio WhatsApp Business Account, e Meta fattura i messaggi direttamente a quell'account, senza alcun ricarico da parte di Genuka. L'abbonamento Genuka WA paga la piattaforma, non i messaggi: non sostituisce la carta che Meta si aspetta sul portafoglio business del cliente.
Quello che vediamo in pratica: un account senza metodo di pagamento può creare modelli e farli approvare, ma ogni invio torna con 131042. E non possiamo verificarlo in anticipo, perché Meta condivide i dati di finanziamento di un account solo con i BSP.
Quando si verifica l'errore 131042?
- Al primo invio di un modello da un account appena collegato, quando nessuno ha ancora aggiunto una carta presso Meta.
- Quando una carta scade o viene rifiutata su un account che prima inviava.
- A metà di una campagna: ogni destinatario fallisce per lo stesso motivo.
Dove lo vedi in Genuka WA?
| Canale | Cosa ottieni |
|---|---|
Risposta di POST /api/v1/messages | Un rifiuto il cui meta.code è 131042, con il testo di Meta in message |
Webhook message_status, quando Meta segnala il fallimento in seguito | data.status: "failed", data.errors[0].code: 131042 |
| Campagna | Ogni destinatario diventa failed. Quando Meta rifiuta già alla chiamata, l'incidente viene anche segnalato una volta per la campagna |
| Dashboard, pagina del cliente, quando Meta rifiuta già alla chiamata | L'avviso "Meta rifiuta gli invii su questo numero", con il messaggio di Meta e un pulsante "Aggiungi una carta su Meta" |
| WhatsApp, quando Meta rifiuta già alla chiamata | Un avviso al partner, al massimo una volta a settimana per numero |
Meta precisa che i suoi errori tornano nella risposta, via webhook o in entrambi
(Meta, error codes).
Genuka WA mostra l'avviso e invia l'allerta WhatsApp solo per un rifiuto ricevuto alla chiamata: un
131042 che arriva solo sul webhook message_status fa diventare il messaggio failed, senza
avviso e senza allerta. Quindi controlla anche il webhook.
Come risolvo l'errore 131042?
Apri le impostazioni di pagamento dell'account presso Meta. Dalla pagina del cliente nella dashboard, il pulsante "Add a card on Meta" apre direttamente la pagina dell'account WhatsApp nelle impostazioni business di Meta, oppure il centro fatturazione quando l'ID del portafoglio non è noto. Deve intervenire il titolare dell'account, cioè il cliente: la carta è sua.
Aggiungi o sostituisci il metodo di pagamento, poi controlla le altre cause dell'elenco di Meta: fuso orario e valuta impostati, account né sospeso né eliminato.
Confermalo in Genuka WA con "Una carta è già registrata". Non possiamo verificarlo noi stessi: l'avviso ricompare da solo se Meta rifiuta un altro invio alla chiamata per lo stesso motivo.
Fai un test con un solo messaggio prima di rilanciare una campagna: un invio accettato e poi consegnato conferma che il blocco è sparito.
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) {
// Nothing to retry: the client has to add a card to their Meta account.
await notifyAccountOwner(json.meta.details ?? json.message); // your function
}
// In your webhook route, once the signature is verified: the same refusal can arrive afterwards.
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");
}Come prevengo l'errore 131042?
- Fai aggiungere la carta durante l'onboarding, prima del primo modello. La dashboard mostra l'avviso "Aggiungi un metodo di pagamento su Meta" su ogni numero finché non viene confermato.
- Spiega fin da subito le due fatture ai tuoi clienti: l'abbonamento Genuka WA da un lato, i messaggi fatturati da Meta dall'altro.
- Non lanciare una campagna grande su un account che non ha mai inviato: un solo messaggio di test rivela il problema al prezzo di un messaggio.
Codici di errore correlati
- 131048: un altro motivo per cui Meta rifiuta gli invii di un numero, legato alla qualità più che al pagamento.
- 132001: un rifiuto che riguarda il modello stesso, a volte scambiato per un blocco dell'account.
Per l'abbonamento Genuka WA in sé, vedi Piani e fatturazione.
FAQ
Il mio abbonamento Genuka WA copre i messaggi WhatsApp?
No. Genuka addebita un abbonamento per numero WhatsApp; i messaggi sono fatturati da Meta, direttamente al WhatsApp Business Account del cliente, senza alcun ricarico da parte di Genuka. Vedi i piani.
Perché Genuka WA non può rilevare la carta mancante prima dell'invio?
Perché Meta condivide i dati di finanziamento di un WhatsApp Business Account solo con i BSP. Essendo Genuka un Tech Provider, il primo segnale affidabile è il rifiuto 131042 stesso.
Chi deve aggiungere la carta?
L'azienda titolare del WhatsApp Business Account, nel proprio portafoglio business Meta. Un partner che gestisce più clienti non può pagare per loro conto tramite Genuka WA.
Fonti
Errore WhatsApp 131026: Message undeliverable — soluzione
Errore WhatsApp 131026 (Message Undeliverable): numero non presente su WhatsApp, condizioni non accettate o app troppo vecchia. Come diagnosticarlo e cosa fare dopo.
Errore WhatsApp 131047: Re-engagement message — soluzione
L'errore WhatsApp 131047 (Re-engagement message) significa che la finestra di 24 ore è chiusa. Perché Meta rifiuta il messaggio libero e come passare a un modello.