01 / Flujo
Conserva la referencia empresarial en cada evento
La integración resulta más fácil de operar cuando el pago, el jugador o pedido y los registros de liquidación comparten referencias desde el principio.
- 01
Crear la sesión
Envía el importe, la divisa, la referencia empresarial y el contexto de retorno requeridos utilizando la estructura de solicitud documentada vigente.
- 02
Presentar la experiencia de pago
Dirige al cliente al checkout o la ruta de pago configurada que se devuelve para esa sesión.
- 03
Procesar los eventos documentados
Valida y gestiona los tipos de evento y campos descritos en la documentación vigente de la API.
- 04
Acreditar y conciliar
Utiliza la referencia para conectar el evento, el jugador o pedido previsto, el importe acreditado y el registro de liquidación.
02 / Operaciones
Decisiones de integración que afectan a las operaciones
Una integración útil hace más que abrir el checkout. Conserva las referencias, estados y rutas de fallo que el operador necesitará después del lanzamiento.
Diseño de referencias
Elige referencias estables de jugador, pedido o factura que puedan encontrarse tanto en el sistema del operador como en el registro de Payfux.
Tratamiento de eventos
Procesa únicamente los campos y estados documentados y conserva la referencia recibida para auditoría y conciliación.
Comportamiento de retorno
Trata el retorno del cliente como navegación de interfaz, no como prueba final de que un pago o una liquidación se ha completado.
Ruta de conciliación
Conecta los registros de pago y liquidación en los sistemas del operador para que las diferencias puedan investigarse mediante su referencia.
03 / Requisitos
Se aplica la documentación vigente
Los ejemplos comerciales describen la secuencia de integración, pero no definen endpoints, cargas, firmas, reintentos, estados o niveles de servicio de producción.
- Utiliza únicamente la autenticación y los campos de solicitud indicados en la documentación de la API vigente para el entorno del cliente.
- No trates el retorno del navegador como evidencia autorizada del pago; utiliza el estado y el modelo de eventos del servidor documentados.
- Prueba la gestión de fallos, duplicados, demoras y cambios de estado conforme al comportamiento documentado para la integración.
04 / Preguntas
Preguntas de los operadores
¿Dónde están los esquemas vigentes de la API de Payfux?
Los esquemas, requisitos de autenticación y campos de solicitud vigentes están en la documentación de la API de Payfux. Los ejemplos de las páginas de producto son explicativos y no la sustituyen.
¿Debe el retorno del navegador marcar un pago como completado?
No. El retorno del cliente es navegación. El operador debe utilizar el estado de pago del servidor y la evidencia de eventos documentados para acreditar y conciliar.
¿Payfux promete un calendario concreto de reintentos de eventos?
En esta página no se afirma un calendario de reintentos. Implementa el comportamiento de eventos y recuperación indicado en la documentación vigente del cliente.
¿Qué referencia empresarial debe enviar el operador?
Utiliza la referencia estable de jugador, cliente, factura o pedido requerida por la integración documentada y consérvala en el sistema del operador.
¿Los registros de prueba y producción son intercambiables?
No. Mantén separados credenciales, endpoints, registros y conciliación de cada entorno y sigue los controles indicados en la documentación.
Documentación para desarrolladores
Empieza por los esquemas vigentes de solicitudes y eventos
Utiliza la documentación de Payfux para conocer el comportamiento exacto de la integración y después alinea las referencias con los sistemas del operador.
Leer la documentación