Si el proveïdor confirma el cobrament però WooCommerce manté Pendent de pagament, el checkout ha creat la comanda però la confirmació no l’ha actualitzada. Pot fallar el webhook, el retorn del navegador, una tasca programada o la resposta de l’API.
No demanis pagar una altra vegada. Relaciona el cobrament existent i protegeix la preparació contra omissions i duplicacions.
Confirma que el pagament correspon
Compara l’import, la moneda, l’hora, la referència del client i la merchant reference. Utilitza l’ID de transacció i el número de comanda, però mai dades de targeta.
Comprova si el proveïdor mostra Capturat, Autoritzat, Pendent o Revertit. Una pantalla d’èxit no garanteix que s’hagin capturat els fons.
Afegeix una nota privada amb l’estat verificat sense canviar encara la comanda manualment.
Llegeix les notes i el registre de passarel·la
Les notes mostren l’inici, el mètode i els callbacks rebuts. Relaciona-les amb WooCommerce > Estat > Registres.
Correlaciona:
- ID de comanda
- ID de transacció
- payment intent o merchant reference
- ID de webhook
- hores i zones horàriesAnonimitza secrets, signatures, tokens i dades personals.
Comprova el lliurament del webhook
Al panell de la passarel·la localitza l’esdeveniment de confirmació. Un 404 suggereix un endpoint incorrecte; 403, el tallafoc; 500, un error de l’aplicació; timeout, una resposta lenta encara que potser s’hagi processat.
No el reenviïs repetidament fins a confirmar idempotència. Una integració correcta reconeix esdeveniments processats, però el codi propi pot duplicar efectes.
Verifica la signatura, el tipus, el compte i l’entorn. Un esdeveniment d’autorització no equival necessàriament a captura, i els reintents poden arribar fora d’ordre.
Verifica l’URL després de canvis
Les migracions, HTTPS, manteniment i idiomes poden alterar l’URL. Confirma que l’endpoint de WooCommerce coincideix amb el configurat i respon públicament amb SSL vàlid.
Exclou els webhooks de caché, login i challenges amplis. Crea una excepció de tallafoc estreta segons els requisits oficials.
El retorn del navegador i el webhook tenen funcions diferents. El client pot tancar la pestanya i el webhook ha de completar la comanda; una pàgina d’agraïment visible tampoc substitueix la confirmació signada.
Inspecciona PHP i les accions
Relaciona el webhook amb els errors PHP. Un error fatal a la passarel·la o en un hook de comanda pot aturar el procés després del cobrament.
Algunes integracions posen treball en cua. Cerca accions fallides o endarrerides de la comanda i corregeix base de dades, cron o PHP abans de reintentar-ne una.
No eliminis les accions: són evidència i poden representar pagaments sense processar.
Revisa personalitzacions d’estat
Un ERP, logística o codi propi pot retornar una comanda pagada a Pendent. Cerca l’actor i l’hora a les notes i hooks de payment_complete.
Utilitza l’API de finalització, no canvis directes a la base de dades:
$order = wc_get_order( $order_id );
if ( $order && ! $order->is_paid() ) {
$order->payment_complete( $transaction_id );
}És il·lustratiu. Verifica la transacció i prioritza l’eina de recuperació de la passarel·la.
Concilia i repara
Classifica cada cas com a pagat, autoritzat, fallit o incert mitjançant evidència del proveïdor. Només després actualitza WooCommerce o reprodueix un esdeveniment verificat.
Corregeix endpoint, SSL, tallafoc, error del connector, cron o hook d’estat. Conserva la traçabilitat en notes privades.
Concilia també estoc i cupons. Abans de forçar l’estat, confirma que no vendrà unitats inexistents ni reutilitzarà un cupó indegudament.
Verifica la transacció següent
Executa una compra controlada i confirma la transició automàtica des de Pendent a l’estat pagat correcte. Revisa estoc, correus, import, ID de transacció i preparació.
Prova també la recepció repetida del mateix webhook: no ha de duplicar canvis.
El manteniment recurrent ha d’alertar sobre comandes Pendents antigues amb pagament confirmat, webhooks fallits i cues acumulades. La conciliació és reparació urgent i control continu.