Un cliente dice que ha pagado, pero el pedido sigue apareciendo como impagado. La wallet puede mostrar la transacción como enviada, mientras que el comercio no logra encontrarla en el registro de pago esperado. Antes de pedir al cliente que vuelva a pagar o asumir que los fondos se han perdido, la empresa necesita una investigación estructurada. Esta guía explica cómo rastrear un pago cripto perdido desde el pedido original y el identificador de la transacción hasta la blockchain, la pasarela de pago y el registro final del comercio.
¿Qué significa realmente «pago cripto perdido»?
Un pago cripto perdido no siempre significa que la transacción haya desaparecido.
En la práctica, la expresión puede describir varias situaciones diferentes:
- el cliente creó una transacción, pero todavía no ha llegado a la red;
- la transacción existe, pero sigue pendiente;
- el cliente envió el pago por una red blockchain incorrecta;
- la dirección de destino o el token eran incorrectos;
- el cliente envió menos del importe solicitado;
- la factura caducó antes de que el cliente completara el pago;
- OxaPay detectó el pago, pero el sistema del comercio no actualizó el pedido;
- el pago existe, pero el comercio no puede asociarlo al cliente o pedido correcto.
Estos casos requieren acciones diferentes. Por tanto, el primer objetivo no es simplemente «encontrar el dinero», sino determinar en qué punto el pago dejó de coincidir con el flujo esperado.
El ciclo de vida de los pagos cripto en un sentido más amplio explica por qué la detección de la transacción, la aceptación del pago, el cumplimiento del pedido y el cierre operativo son etapas independientes. Un pago puede ser visible on-chain sin haber producido todavía el resultado comercial esperado.
Antes de empezar: no pidas al cliente que vuelva a pagar
Un segundo pago puede convertir una investigación sencilla en un problema de pago duplicado y reembolso.
Hasta que se haya localizado y clasificado la primera transacción, Soporte no debe pedir al cliente que vuelva a enviar los fondos. Tampoco debe solicitar nunca al cliente:
- la clave privada;
- la seed phrase o frase de recuperación;
- la contraseña de la wallet;
- el código de autenticación.
La investigación solo requiere referencias de pago e información de la transacción que pueda verificarse públicamente.
Investigación de un pago cripto perdido: paso a paso
Paso 1: recopila las referencias del pago
Empieza por los propios registros del comercio en lugar de buscar inmediatamente en la blockchain.
Solicita o recupera:
| Información necesaria | Finalidad |
|---|---|
| ID del pedido o factura | Identifica la solicitud comercial |
| OxaPay track ID | Identifica la sesión de pago de OxaPay |
| ID de transacción o TXID | Identifica la transacción blockchain |
| Criptomoneda | Confirma qué activo se envió |
| Red blockchain | Determina en qué red debe buscarse la transacción |
| Importe enviado | Revela un pago insuficiente o una discrepancia de importe |
| Hora aproximada del pago | Acota la investigación |
| Resultado esperado | Muestra si el cliente espera una entrega, crédito en cuenta, renovación u otro resultado |
Cuando los comercios generan una factura de OxaPay, pueden incluir su propio order_id. OxaPay también proporciona un track_id que pueden usar después para recuperar el registro de Payment Information correspondiente.
La combinación de Order ID, track ID y TXID ofrece tres perspectivas diferentes:
- Order ID: qué intentaba comprar el cliente;
- Track ID: cómo representa el pago la pasarela;
- TXID: qué ocurrió en la blockchain.
El artículo de OxaPay ID de transacción cripto explicado ofrece una explicación sencilla para clientes sobre cómo encontrar y utilizar un TXID para rastrear una transferencia.
Paso 2: confirma que el TXID es válido
Una captura de pantalla de la wallet que indique «enviado» no demuestra que la wallet haya difundido correctamente la transacción a la red.
Copia directamente el TXID y búscalo con un explorador de bloques de la red que el cliente afirma haber utilizado.
Comprueba si:
- el explorador reconoce el TXID;
- la transacción pertenece a la blockchain esperada;
- la transacción está pendiente, confirmada, fallidao sigue sin resolverse;
- la hora de envío coincide con el intento de pago.
Redes como Ethereum generan un hash de transacción cuando un usuario envía una transacción. Después, la red difunde la transacción y espera a incluirla en un bloque. Del mismo modo, las transacciones de Bitcoin reciben confirmaciones después de que los mineros las incluyan en bloques.
Si no puedes encontrar el TXID
Las posibles explicaciones incluyen:
- el TXID se copió incorrectamente;
- el cliente está buscando en la red equivocada;
- la wallet creó la transacción localmente, pero no la difundió;
- la wallet muestra una referencia interna en lugar del TXID de la blockchain;
- la transacción nunca se envió correctamente.
Pide al cliente que abra los detalles de la transacción en su wallet y confirme la red exacta y el TXID.
No marques el pedido como pagado cuando no pueda encontrarse una transacción verificable.
Paso 3: verifica la red, el activo, la dirección y el importe
Encontrar la transacción es solo el principio. La transacción debe coincidir con la solicitud de pago.
Compara cuatro datos.
Red
Confirma que el pago se envió por la red seleccionada durante el checkout.
Esto es especialmente importante para activos como USDT y USDC, que pueden existir en varias redes. Una transacción realizada en una red no aparecerá al buscarla en otra.
Activo
Confirma que el cliente envió la criptomoneda o el contrato de token esperado.
El mismo formato de dirección puede existir a veces en redes compatibles, pero eso no significa que todos los tokens o rutas de red sean compatibles.
Dirección de destino
Compara la dirección del destinatario en la transacción blockchain con la dirección mostrada en la solicitud de pago.
Una transacción confirmada enviada a una dirección diferente no está perdida en la blockchain. Se envió por una ruta distinta.
Importe
Compara el importe recibido con el importe solicitado.
El cliente puede haber:
- introducido un importe incorrecto;
- pagado solo una parte de la factura;
- malinterpretado qué comisiones eran independientes del importe del pago;
- enviado varias transacciones más pequeñas en lugar de un único pago completo.
Una pasarela de pago profesional evalúa la red, el destino, el token, el importe, el momento y las pruebas de confirmación antes de clasificar una transferencia como pago válido.
Paso 4: determina el estado en la blockchain
Si la transacción existe y los datos del pago son correctos, determina si ha avanzado lo suficiente como para ser aceptada.
Pendiente o sin confirmar
La red ha detectado la transacción, pero todavía no ha alcanzado el estado de confirmación o finalidad requerido.
En este caso:
- no pidas al cliente que vuelva a enviar los fondos;
- explica que la transacción ha sido localizada;
- indica al cliente un próximo punto de revisión claro;
- sigue comprobando según la política de pagos del comercio.
El tiempo de confirmación varía según la red y las condiciones actuales. La visibilidad de la transacción y la finalidad del pago no deben tratarse como el mismo evento.
Confirmada
Una transacción confirmada demuestra que la red procesó la transferencia. No demuestra automáticamente que el pago haya satisfecho la factura del comercio.
La dirección, el activo, el importe, la red, el momento de la factura y el registro de pago relacionado deben seguir coincidiendo.
Fallida o no completada
Si el explorador muestra que la transacción falló, el pago no se completó como estaba previsto.
Soporte debe explicar el resultado verificado y pedir al cliente que revise su wallet antes de intentar otro pago. El comercio no debe marcar el pedido como pagado basándose únicamente en el intento de transferencia.
Paso 5: revisa el registro de pago de OxaPay
Una vez entendidas las pruebas de la blockchain, revisa el registro de OxaPay utilizando el track ID.
En OxaPay, Payment Information de OxaPay , como endpoint, recupera información detallada de un pago concreto. Payment History también puede filtrarse por track ID, estado, tipo de pago, activo, red, importe, dirección y rango de fechas.
Compara:
- el estado de OxaPay;
- el importe esperado y recibido;
- la moneda del pago;
- la red;
- la información de la transacción;
- el momento de la factura;
- la referencia del pedido del comercio.
OxaPay documenta los estados de pago siguientes:
- new;
- waiting;
- paying;
- paid;
- manual_accept;
- underpaid;
- refunding;
- refunded;
- expired.
Qué puede indicar el estado
| Estado de OxaPay | Significado para la investigación |
|---|---|
| New o waiting | Todavía no se ha asociado a la factura ningún pago válido |
| paying | Existe actividad de pago, pero el pago aún no se ha aceptado por completo |
| paid | OxaPay ha aceptado la factura como pagada por completo |
| underpaid | Se recibió un pago, pero no se completó el importe requerido |
| expired | La factura no se completó dentro de su periodo de pago activo |
| Manual accept | El comercio aceptó manualmente el pago |
| Refunding o refunded | El pago está pasando por un proceso de reembolso o ya lo ha completado |
Si OxaPay muestra paid mientras el pedido del cliente sigue impagado, la investigación ya no se centra en la blockchain. El problema probable está ahora en la actualización del pedido, la integración o el proceso de cumplimiento del comercio.
Paso 6: compara el pago con el pedido del comercio
Comprueba si el registro de pago de OxaPay está vinculado al pedido interno correcto.
Verifica:
- el Order ID almacenado;
- el track ID almacenado;
- el importe esperado;
- el cliente o la cuenta;
- el estado del pedido;
- el estado de cumplimiento o crédito en cuenta;
- cualquier edición manual o acción previa de Soporte.
Este paso suele revelar uno de tres resultados.
El pago es correcto, pero el pedido no se actualizó
El pago no está realmente perdido. El sistema del comercio no consiguió traducir el estado del pago en la acción comercial esperada.
Si la integración depende de callbacks, revisa la configuración de Webhook de OxaPay y la ruta de entrega antes de tratar el caso como un problema de blockchain.
Escala el caso a Payment Operations o Engineering con todos los identificadores y estados actuales.
El pago se vinculó al pedido equivocado
No muevas silenciosamente el pago sin registrar la decisión.
Confirma el cliente y el pedido correctos, corrige la asociación mediante el proceso aprobado y conserva un registro de auditoría.
No se puede asociar ningún pedido con confianza
Coloca el pago en una cola de excepciones. Utiliza el importe, la hora, la dirección, los datos del cliente y el TXID como pruebas de apoyo, pero no hagas suposiciones cuando los datos disponibles puedan coincidir con varios pedidos.
El proceso detallado de asociación se tratará en How to Match Orders, Track IDs, and Blockchain Transactions.
Paso 7: clasifica la causa raíz
Al final de la investigación, el caso debe tener una clasificación clara.
| Hallazgo | Causa probable | Siguiente acción |
|---|---|---|
| No hay un TXID válido | La transacción no se difundió o la referencia es incorrecta | Volver al cliente para verificar la wallet |
| El TXID existe, pero la transacción está pendiente | El procesamiento de la red está incompleto | Supervisar y fijar un punto de seguimiento |
| Red, token o dirección incorrectos | La ruta del pago no coincide con la solicitud | Escalar sin prometer recuperación |
| El importe es demasiado bajo | Pago insuficiente | Aplicar la política de pagos insuficientes del comercio |
| El pago llegó después de la expiración | Pago tardío o expirado | Revisar según la política de facturación |
| OxaPay muestra paid, el pedido muestra unpaid | Problema de sincronización o cumplimiento del lado del comercio | Escalar internamente |
| El pago existe, pero no coincide con ningún pedido | Falta una referencia o hay un problema de correlación | Crear una excepción de conciliación |
| El reembolso está en curso | El pago original ha entrado en un proceso de reversión | Seguir el reembolso en lugar de la aceptación del pago |
OxaPay ofrece opciones específicas para facturas con pagos insuficientes y facturas expiradas, como revisión por parte del comercio, aceptación, ampliación o reembolso, según el escenario y el comportamiento actual del producto. Cómo OxaPay gestiona facturas con pago insuficiente y expiradas explica estos casos con más detalle.
¿Cuándo debe escalarse el caso a OxaPay?
Escala una investigación del lado del proveedor cuando:
- la transacción blockchain coincide con la dirección, red, activo, importe y momento esperados, pero no aparece ningún pago correspondiente en OxaPay;
- Payment Information y Payment History muestran resultados contradictorios;
- el estado del pago no refleja las pruebas disponibles de la transacción;
- un reembolso o una acción manual de pago sigue sin resolverse;
- el comercio no puede explicar el registro del proveedor utilizando la documentación disponible.
Proporciona un caso completo:
- referencia de Merchant API o cuenta cuando corresponda;
- track ID;
- order ID;
- TXID;
- activo y red;
- el importe esperado y recibido;
- hora del pago;
- estado actual de OxaPay;
- pruebas del explorador blockchain;
- estado del pedido del comercio;
- descripción concisa de la discrepancia.
Una escalación completa reduce las preguntas repetidas y ayuda a separar una investigación del proveedor de los problemas del cliente, la wallet o la integración del comercio.
Cómo prevenir casos de pagos perdidos
Muchas investigaciones de pagos perdidos empiezan con referencias débiles o instrucciones poco claras para el cliente.
Los comercios pueden reducir futuros casos si:
- guardan el order ID y el track ID al crear el pago;
- muestran claramente el activo, la red, el importe y la fecha límite de pago;
- conservan los registros de pago después del checkout;
- mantienen a los clientes informados con estados de pago útiles;
- supervisan los pedidos paid que siguen sin cumplirse;
- mantienen una única cola de excepciones compartida;
- prueban escenarios de retraso, pago insuficiente, expiración y fallo de pago;
- forman a Soporte para solicitar las pruebas correctas.
En OxaPay, Generate Invoice endpoint admite un order_id interno, mientras que Payment Information y Payment History ayudan a los comercios a recuperar y revisar los registros de pago. En conjunto, estas referencias crean una pista de investigación más sólida.
Cómo ayuda OxaPay a investigar pagos perdidos
OxaPay ofrece varias capas de visibilidad del pago:
- order_id para la referencia interna del comercio;
- track_id para la sesión de pago de OxaPay;
- Payment Information para un pago concreto;
- Payment History para búsquedas más amplias a nivel de cuenta;
- estados de pago documentados;
- gestión de facturas para casos de pago insuficiente y expiración.
Estas herramientas ayudan a los comercios a determinar si un pago reportado está perdido, pendiente, insuficientemente pagado, expirado, sin asociar o ya aceptado.
El comercio sigue siendo responsable de conectar el pago con sus propios registros de pedido, cliente, cumplimiento y soporte.
Investiga el pago antes de decidir el resultado
Un pago perdido debe tratarse como un problema de pruebas, no como una suposición.
La secuencia correcta de investigación es:
- recopilar el order ID, track ID y TXID;
- verificar que la transacción existe en la red esperada;
- comparar el activo, la dirección, el importe y el momento;
- determinar si la transacción está pendiente o confirmada;
- revisar el registro de pago de OxaPay;
- compararlo con el pedido del comercio y el estado de cumplimiento;
- clasificar la causa raíz y asignar la siguiente acción correcta.
Este proceso evita pagos duplicados, cumplimientos incorrectos, promesas de recuperación no justificadas y casos de clientes sin resolver.
La pasarela de pagos cripto de OxaPay ofrece a los comercios las referencias de pago, registros de estado e historial necesarios para rastrear la actividad de pago. Conecta estas capacidades con un proceso de investigación coherente para que los clientes reciban respuestas claras y cada pago llegue a un resultado documentado.
