Número único de operación
Vincula al jugador, el importe, la moneda, el método de pago, el proveedor de pagos y todo el historial de procesamiento.
Documentación / Flujo de pagos
Cómo funciona la API de pagos
Revise el recorrido completo del pago: desde la creación de un depósito y la confirmación del pago hasta el abono de fondos, las retiradas, los reembolsos y la conciliación financiera.
Depósito
creación y abono
Pago
verificación y envío
Estados
confirmación de operaciones
Conciliación
control financiero
Flujo de pagos
De la solicitud al resultado final
01
Crear la operación
Registre el jugador, el importe, la moneda, el método de pago y el número único de operación.
02
Confirmar el pago
Redirija al jugador a la página de pago, solicite la confirmación del banco o procese el pago directamente.
03
Recibir el estado final
Compruebe la respuesta del proveedor de pagos y confirme el resultado final de la operación.
04
Actualizar el saldo y la contabilidad
Abone o cargue los fondos una sola vez, contabilice la comisión y registre la operación para la conciliación.
Resumen
Cada pago sigue fases controladas
La plataforma asigna su propio número de operación, lo vincula a la respuesta del proveedor de pagos y cambia el estado financiero solo después de un resultado confirmado. Una solicitud repetida no debe crear un segundo débito o abono.
Estados claros
La operación solo pasa por fases permitidas y no cambia un resultado completado sin un ajuste independiente.
Contabilidad financiera independiente
El estado del pago, el cambio de saldo, la comisión y el asiento contable están vinculados, pero se comprueban por separado.
Flujo de depósito
Flujo habitual de depósito
Un depósito comienza con una operación interna y termina con un único abono después de la confirmación del proveedor de pagos.
01
Validar la solicitud y crear la operación
La plataforma comprueba al jugador, el KYC, los límites, la moneda, el importe y el método de pago, y después asigna un número interno de operación.
02
Enviar el pago al proveedor
El proveedor recibe el importe, la moneda, los datos del jugador, la URL de retorno, la URL de notificación y los datos de pago necesarios.
03
Confirmar el pago
El jugador confirma el pago en una página externa, mediante 3-D Secure o en una aplicación bancaria.
04
Recibir la confirmación y abonar los fondos
Después de validar la firma y el estado final, la plataforma aumenta el saldo del jugador una sola vez y completa la operación.
Retirada y reembolso
Retiradas, cancelación y reembolsos
Las operaciones salientes requieren verificar al jugador, el saldo disponible, el riesgo, los datos de pago y la respuesta final del proveedor de pagos.
Verificación del jugador
KYC, edad, estado de la cuenta, límites, autoexclusión y métodos de retirada permitidos.
Comprobaciones de riesgo
AML, indicadores de fraude, condiciones de apuesta, origen de fondos y aprobación del operador.
Reservar el importe
El importe queda retenido en el saldo hasta recibir el resultado final del pago.
Enviar al proveedor de pagos
Se crea una solicitud de pago independiente con un número único y datos del destinatario verificados.
Esperar el resultado
La plataforma acepta estados intermedios y no vuelve a cargar el importe.
Reembolso
Un reembolso se crea como una operación independiente vinculada al pago original y con su propio importe.
Cancelación
La cancelación solo es posible antes de la fase irreversible y no sustituye un reembolso de una operación ya completada.
Conciliación final
El informe del proveedor, los datos del pago, las comisiones y los cambios de saldo deben mostrar el mismo resultado.
Estados de la operación
Modelo de estados recomendado
Los estados internos normalizan las diferentes respuestas de los proveedores de pago en un único modelo claro para la plataforma.
Creada
La operación se ha creado en la plataforma, pero todavía no se ha enviado al proveedor ni ha sido aceptada por este.
Acción necesaria
El jugador debe confirmar el pago, introducir datos o realizar una acción con su banco.
En proceso
El proveedor ha aceptado la operación, pero el resultado final todavía no se ha confirmado.
Completada
La operación ha finalizado correctamente y, después, el saldo se modifica una sola vez.
Rechazada
La operación ha terminado con un rechazo, conservando el motivo y sin otro débito o abono.
Sin confirmar
El resultado de la operación es desconocido debido a un fallo de conexión, un retraso en la respuesta o datos contradictorios.
Un resultado desconocido no puede tratarse como un rechazo
El proveedor puede haber aceptado el pago aunque no haya respondido a tiempo. Primero solicite el estado actual o espere una confirmación y solo después decida si hace falta otra operación.
Fiabilidad y conciliación
Protección frente a duplicados y conciliación financiera
La fiabilidad de la API de pagos depende de un comportamiento seguro ante solicitudes repetidas, confirmaciones retrasadas y fallos parciales.
Protección frente a operaciones repetidas
Cada depósito, retirada y reembolso recibe un número único.
Una solicitud repetida devuelve el resultado existente y no crea una nueva operación financiera.
Una notificación repetida se comprueba con el número de evento y el estado actual del pago.
El cambio de saldo se vincula al número de pago y se aplica una sola vez.
Contabilidad financiera y conciliación
Guarde por separado el importe, la comisión, el importe neto, la moneda y la referencia del proveedor.
No reescriba retrospectivamente un asiento completado; cree un ajuste independiente.
Concilie las operaciones de API, los informes del proveedor, los cambios de saldo y los pagos.
Registre cada discrepancia, su causa, responsable y resultado de resolución.
Pruebas
Qué probar antes del lanzamiento
Pruebe el pago correcto, el rechazo, la pérdida de conexión, la confirmación repetida, el resultado desconocido, el reembolso y la conciliación financiera.
Depósito y retirada correctos
Todos los estados intermedios, la confirmación, el cambio de saldo y el informe final.
Rechazo de la operación
Fondos insuficientes, datos no válidos, límite superado, rechazo del banco, revisión de riesgo y método de pago no disponible.
Pérdida de conexión
La conexión se interrumpe después de enviar la solicitud y la confirmación llega más tarde o se solicita por separado.
Solicitudes repetidas
La misma operación o confirmación vuelve a llegar después de terminar el procesamiento.
Reembolso y cancelación
Reembolso total y parcial, cancelación antes del procesamiento y prohibición de cancelar una operación completada.
Conciliación
El importe, la comisión, el estado final, el saldo y el informe del proveedor coinciden después de todos los escenarios.
Lista de comprobación previa al lanzamiento
Los pagos de producción se habilitan después de verificar los estados, las confirmaciones, la protección frente a duplicados, los saldos y los informes financieros.
Los entornos de pruebas y producción utilizan credenciales, endpoints de notificación y cuentas diferentes.
El retorno del usuario al sitio web no se utiliza como prueba de que el pago se haya realizado correctamente.
La firma y el número de evento se verifican antes de modificar el saldo.
Los depósitos, retiradas y reembolsos están protegidos frente a ejecuciones repetidas.
Un estado desconocido se aclara con el proveedor y se comprueba durante la conciliación.
Están configuradas las alertas de errores, los informes de PSP y un proceso de investigación de discrepancias.
¿Necesita diseñar un flujo de pagos?
Envíenos la lista de PSP, métodos de pago, monedas, mercados, reglas de saldo y estados. APIACE ayudará a estructurar depósitos, retiradas, reembolsos, confirmaciones y conciliación financiera.