Pedido, cuenta por cobrar, reserva u otra referencia comercial duradera que pertenece a tu negocio.
Guía para desarrolladores
Un pago es un ciclo de vida, no una sola llamada API.
Mantén conectados la referencia de negocio, la decisión de pago, la ejecución del proveedor y el resultado financiero como una única operación trazable, desde el contexto inicial hasta autenticación, cambios de estado, cancelación o reembolso.
01Preparar
02Simular
03Ejecutar
04Autenticar
05Observar
06Ajustar
Límite de integración
Identidad estable durante todo el ciclo
La integración comienza con una referencia perteneciente al negocio y produce una identidad transaccional duradera que puede permanecer conectada con la ejecución del proveedor y el estado financiero posterior. Así, la obligación comercial no depende de una única solicitud a un proveedor.
Identidad de plataforma utilizada para seguir la operación mientras cambian el proveedor y el canal.
Los resultados de autorización, autenticación y ejecución permanecen ligados a la transacción.
Cancelación, reembolso, liquidación o conciliación posteriores pueden continuar desde el mismo ciclo.
Patrón probado
Previsualiza antes de ejecutar
Un paso de decisión puede evaluar el contexto de la transacción antes de mover dinero. El patrón probado separa elegibilidad y selección de ruta de la ejecución para poder razonar sobre el camino y la economía esperada antes de comprometer la operación.
- Utiliza importe, divisa, contexto de cliente o cuenta y reglas comerciales para definir elegibilidad.
- Evalúa un proveedor o ruta de ejecución elegible antes de la llamada final de pago.
- Mantén explicables la economía esperada y la elección de proveedor como parte de la decisión.
- Ejecuta solo cuando la aplicación disponga de la decisión que necesita.
Modelo conceptual de objeto — no es un esquema actual de API
{
"reference": "your-business-reference",
"payment_context": {
"amount": "...",
"currency": "...",
"channel": "..."
},
"transaction": {
"id": "durable-transaction-id",
"state": "..."
},
"decision": {
"eligible_path": "...",
"expected_economics": "..."
}
}Modelo de implementación
Operaciones del ciclo de vida
Estos patrones describen comportamientos de integración probados en sistemas de producción. Definen el modelo técnico; no prometen que la API actual de Zopio vaya a utilizar un endpoint, campo o formato de contrato concreto.
Preparar
Reúne el contexto comercial y de pago necesario para formar una experiencia elegible.
Simular
Evalúa la ruta elegible y la economía esperada antes de ejecutar.
Ejecutar
Inicia el pago a través de la ruta conectada seleccionada.
Autenticar
Completa la autenticación del cliente exigida por el proveedor cuando sea necesaria.
Observar
Usa cambios de estado, eventos y consultas para comprender el resultado actual.
Ajustar
Continúa el ciclo con finalización, cancelación, reembolso u otra acción posterior permitida.
Seguir explorando
Hablar sobre tu integración