Ir al contenido

API

En esta página

Simular pago

Lleva una factura de Sandbox a un desenlace de pago y prueba el mismo ciclo de vida y los mismos webhooks que una transferencia confirmada en cadena.

POST/v1/sandbox/invoices/:invoice_id/simulate-payment

Clave de API: Payment · Entorno: solo Sandbox

Simula un pago confirmado sin mover fondos reales. La factura debe pertenecer al comercio autenticado y al entorno de Sandbox. Una clave de producción se rechaza.

Cuerpo de la petición

stage es obligatorio y admite exactamente uno de estos valores:

  • paid — pagar el importe esperado;
  • overpaid — pagar un 10 % por encima del importe esperado;
  • underpay — pagar el 40 % del importe esperado; las reglas de dominio de la factura deciden si sigue abierta o pasa a ser final;
  • cancel — cancelar una factura que todavía admite cancelación.
{
  "stage": "paid"
}

El servidor deriva de la factura todos los importes simulados. Los clientes nunca calculan importes de liquidación.

Respuesta (200 OK)

Devuelve el recurso de factura actualizado y emite los mismos eventos de webhook del ciclo de vida que el desenlace real equivalente. Los campos de la respuesta están en Obtener factura.