Resumen de la API
/orders/{id} y /orders/{id}/ están disponibles actualmente. El ID del pedido forma parte del enlace de pago y debe considerarse un identificador opaco sensible; no lo divulgue públicamente.
Consulta anónima
La página de pago puede leerse directamente cuando se pierde la sesión de inicio:id, description, price, state, pay_way, pay_url, expired_at, created_at. No devuelve cuenta, Application, Package, identificadores internos de pago ni metadata.
Consulta autenticada
application / applications, package / packages, bank_details, invoice_automation y los campos del modelo. Si está autenticado pero no es el propietario del pedido, devuelve 403; excepto los superadministradores.
Campos clave
La respuesta completa puede incluir campos adicionales según el método de pago; el cliente debe leerlos según sea necesario y evitar siempre registrar metadata sensible de la respuesta completa.
Manejo de errores
404: el ID del pedido no existe.403: ha iniciado sesión, pero no es el propietario del pedido.- Las solicitudes anónimas no devuelven
401; solo obtienen la proyección pública mínima.
Reversión de factura y nueva solicitud
MedianteGET /api/v1/orders/{order_id}/invoice/ se puede leer la factura actual del pedido. Después de enviar la reversión automática, la factura sigue siendo Issued, y red_state indica el progreso de la reversión; un envío exitoso no equivale a que la reversión se haya completado. Mientras se espera la confirmación, se emite la factura roja o se archiva, el pedido no puede volver a solicitar una factura.
Cuando un administrador solicita una reversión debido a errores en la información de facturación, como el encabezado o el número de identificación fiscal, el motivo de la reversión es «error de facturación»; la reversión automática activada por el reembolso del pedido sigue utilizando «cancelación del servicio».
Después de que la factura roja se emita y archive correctamente, la factura original pasa a ser Voided, y solo entonces el pedido puede volver a solicitarse. La factura original puede consultarse en el historial de facturas. Si la reversión falla o el resultado está pendiente de verificación, el departamento financiero se encargará de la comprobación, y el pedido no eliminará anticipadamente la restricción de facturación. Las facturas emitidas manualmente deben primero anularse o revertirse en el sistema fiscal o de facturación, y luego ser confirmadas por el departamento financiero en la plataforma.

