IOPAY→Desarrolladores→Sellers API
Participar de la plataforma

Sellers API

Referencia interna para modelar, registrar y seguir a los participantes utilizados en operaciones de plataforma, mercado y Split.

ObjetoSeller
UsoMercado · Split
Estado de la ComunidadMigración de documentación
Ciclo del seller Datos esenciales Se divide
Visión general

Visión general

Utilice la capa de Sellers para dar identidad operativa a los participantes de una plataforma o mercado. Este contexto se utiliza para jornadas en las que la recepción, la división, las reglas comerciales o la conciliación dependen de quién participa en la transacción.

Identidad

Un documento de identificación por participante.

Mantenga el vínculo entre su registro interno y el identificador devuelto por IOPAY.

Registro

Datos consistentes.

Envíe información completa de cadastro según el tipo de seller y la operación.

Operación

Contexto para Split.

El seller se convierte en jornadas multiparticipante y procesos de conciliación.

Ciclo del seller

El flujo de seller

01 · OrigenSu registro.

El participante nace en su sistema con un identificador propio.

02 · IOPAYCrear el seller.

Envía los datos necesarios y guarde la identificación devuelta.

03 · EstadoAcompanhe.

Valida el estado y las pendientes antes de utilizar seller operacionalmente.

04 · PagosUtilice el contexto.

Asociar seller a flujos compatibles de mercado y Split.

Modelado

Modelado

ReferenciaUsoRecomendación
seller_internal_idIdentificador del participante en su dominio.Nunca dependas solo de la identificación externa.
iopay_seller_idIdentificador devuelto por IOPAY.Persiste inmediatamente después de la creación/consulta.
statusEstado de funcionamiento conocido.Actualice según las revisiones y devoluciones.
documentDocumento de registro aplicable al participante.Proteja de acuerdo con la ley LGPD y política interna.
Operación

Reglas de funcionamiento

  • Valida seller antes de construir una regla de Split.
  • No reutilice IDs entre diferentes participantes.
  • Registre cambios de registro relevantes.
  • Tratar de estado no elegible antes de crear una operación financiera.
  • Use filas y reprocesamiento para integraciones que dependen de revisión asíncrona.
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 —