Desarrolladores
Referencia de la API
GET /status/:reference

GET /status/:reference

Consulta el estado de cualquier transacción (tarjeta o QR) por su reference.

Auth: público — no requiere x-wpay-key. Pensado para que tus páginas de éxito/fallo lo consulten directo desde el navegador.

⚠️

Aunque el navegador puede consultarlo, la fuente de verdad para marcar un pedido como pagado debe ser tu backend (esta misma llamada servidor a servidor) o un webhook.

Response 200

{
  "reference": "WP-1784169095747-578AFA46",
  "status": "APROBADO",
  "amount": 350.0,
  "order_id": "ORD-1042",
  "name": "Pedido #1042",
  "payment_method": "CARD",
  "created_at": "2026-07-16 10:22:41"
}

Si la reference no existe:

{ "status": "NOT_FOUND" }

(Nota: responde 200 con NOT_FOUND, no 404.)

statusSignificado
PENDIENTESin completar.
PENDING_3DSEsperando verificación 3DS del cliente.
APROBADOPagada. ✅
RECHAZADORechazada por el banco.
FALLIDOError técnico.
CANCELADOCancelada por el comercio.
NOT_FOUNDLa referencia no existe.

Pruébalo

Pega la reference de una transacción creada en /payment/init:

GET/status/WP-PEGA-AQUI-TU-REFERENCE⚡ Simulador — se ejecuta en tu navegador
Ver cURL equivalente (producción)
curl -X GET "https://api.wizpay.app/status/WP-PEGA-AQUI-TU-REFERENCE"