IOPAY→Developers→Split API
Sellers & distribución

Split API

Central interna para organizar la integración de la distribución entre participantes, del registro de los sellers a la conciliación del resultado.

Requisito previoSellers identificados
UsoDistribución multiparticipante
EstadoMigración de la documentación
Modelo de integración Checklist Sellers →
Visión general

Visión general

Usa 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 sellers previamente identificados y reglas de distribución compatibles con el contrato de la operación.

Participantes

Sellers identificados.

Cada destino debe estar correctamente representado en la plataforma.

Regla

Distribución explícita.

Monta la composición del split según el modelo comercial y el contrato vigente.

Conciliación

Referencia preservada.

Mantén los IDs internos para conciliar pedido, transacción y participantes.

Modelo de integración

Flujo

01 · RegistroIdentifica a los sellers.

Asegura que cada participante esté habilitado para la operación.

02 · ReglaMonta la distribución.

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

03 · PagoCrea la transacción.

Lleva la regla de split al flujo compatible con la API.

04 · FinanzasConcilia.

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

Estructura recomendada

Modelado

Campo lógicoPara qué sirveBuena práctica
reference_idCorrelacionar el pago con tu pedido/operación.Usa 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 / percentageRepresentar la regla de distribución cuando el contrato lo admita.Evita redondeos ambiguos.
metadataContexto interno complementario cuando esté disponible.No almacenes secretos ni datos sensibles innecesarios.
Contrato de rutas. Los nombres exactos de campos y endpoints deben migrarse de la collection oficial a esta página antes de eliminar definitivamente la referencia externa.
Checklist

Checklist

  • Sellers registrados y elegibles para la operación.
  • Regla de distribución validada con finanzas/comercial.
  • Validación de la suma de valores/porcentajes.
  • Referencia interna del pedido preservada.
  • Webhooks conectados al ciclo transaccional.
  • Conciliación y tratamiento de cancelaciones/reembolsos definidos.
Migración de la documentación

Referencia externa temporal

Mientras no se complete la migración de los endpoints, usa la collection de Postman para verificar el contrato técnico.

Abrir collection técnica ↗