IOPAY→Desarrolladores→API de división
Sellers & distribución

API de división

Centro interno para organizar la integración de la distribución entre participantes, desde el registro de los vendedores hasta la conciliación del resultado.

Pre-requisitoSellers identificados
UsoDistribución multiparticipante
Estado de la ComunidadMigración de documentación
Modelo de integración Lista de control Sellers →
Visión general

Visión general

Utilice Split cuando una operación necesita dirigir valores a múltiples participantes dentro de un mismo contexto de pago. La implementación debe partir de vendedores previamente identificados y de reglas de distribución compatibles con el contrato de la operación.

Participaría

Sellers identificados.

Cada destino debe estar correctamente representado en la plataforma.

Regla

Distribución explícita.

Elige la composición del split de acuerdo con el modelo comercial y el contrato vigente.

Conciliación

Referencia conservada.

Mantenga IDs internos para reconciliar solicitud, transacción y participantes.

Modelo de integración

Flujo

01 · RegistroIdentifique a los vendedores.

Asegúrate de que cada participante esté preparado para la operación.

02 · ReglaEncienda el reparto.

Define participantes y valores/percentajes según el contrato.

03 · PagamientoCrear la transacción.

Llevar la regla de división al flujo compatible con API.

04 · FinanzasReconcilie.

Utilice referencias y eventos para seguir el resultado de la operación.

Estructura recomendada

Modelado

Campo lógico¿Para qué sirve?Buenas prácticas
reference_idCorrelación de pago con su solicitud/operación.Utilice un valor estable y único.
seller_idIdentificar al participante que recibirá parte de la operación.Valida el seller antes de montar el split.
amount / percentagePresentar la regla de distribución cuando sea respaldada por el contrato.Evite redondeos ambiguos.
metadataContexto interno complementario cuando esté disponible.No almacenes secretos o datos sensibles innecesarios.
Contrato de rutas. Los nombres exactos de los campos y puntos finales deben ser migrados de la colección oficial a esta página antes de eliminar definitivamente la referencia externa.
Lista de control

Lista de control

  • Sellers registrados y elegibles para la operación.
  • Regla de distribución validada con carácter financiero/comercial.
  • Validación de la suma de valores/percentajes.
  • Referencia interna de la solicitud conservada.
  • Webhooks conectados al ciclo de transacciones.
  • Conciliación y tratamiento de cancelaciones/retornos definidos.
Migración de la documentación

Referencia externa temporal

Mientras no se complete la migración de los puntos finales, utilice la colección Postman para comprobar el contrato técnico.

Abre la colección técnica —