Visión general
La Sellers API está destinada a socios autorizados que necesitan registrar y gestionar sellers clientes dentro de IOPAY. La integración permite crear sellers persona física o jurídica y utilizar el io_seller_id devuelto en las demás operaciones de la API.
IO Seller ID.
Cada seller recibe un io_seller_id que debe persistirse y utilizarse en las siguientes operaciones.
Persona física o jurídica.
Existen flujos específicos para registrar sellers individuales y empresas.
Cuenta bancaria vinculada.
Para recibir payouts, el seller debe tener vinculada una cuenta bancaria de la misma titularidad.
Flujo del seller
Envía los datos de persona física o jurídica a la Sellers API.
Persiste el io_seller_id devuelto por IOPAY.
Registra una cuenta bancaria de la misma titularidad y asocia el token al seller.
El seller podrá entonces participar en los flujos compatibles de la plataforma.
Registro
| Método | Endpoint | Uso |
|---|---|---|
POST | /v1/sellers/create/individuals | Crear seller persona física. |
POST | /v1/sellers/create/businesses | Crear seller persona jurídica. |
PATCH | /v1/sellers/update/individuals/:IO_SELLER_ID | Actualizar seller persona física. |
PATCH | /v1/sellers/update/businesses/:IO_SELLER_ID | Actualizar seller persona jurídica. |
GET | /v1/sellers/mcc_list | Consultar los MCCs disponibles. |
Crear seller · Persona física
curl --request POST \
--url https://api.iopay.com.br/api/v1/sellers/create/individuals \
--header 'Authorization: Bearer tu_token' \
--header 'Content-Type: application/json' \
--data '{
"send_welcome_email": true,
"mcc": 5499,
"first_name": "André",
"last_name": "Silva",
"email": "[email protected]",
"revenue": 4500,
"phone_number": "(11)999999999",
"cpf": "12345678909",
"birthdate": "2000-01-01",
"statement_descriptor": "LOJA ANDRE",
"address": {
"line1": "Av Paulista",
"line2": "1000",
"line3": "Sala 10",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zip_code": "01310100",
"country_code": "BR"
}
}'io_seller_id devuelto por IOPAY. Identifica al seller en las operaciones posteriores.Crear seller · Persona jurídica
{
"mcc": 5499,
"statement_descriptor": "LOJA EXEMPLO",
"revenue": 250000,
"business": {
"name": "Empresa Exemplo LTDA",
"email": "[email protected]",
"phone_number": "(11)999999999",
"cnpj": "12345678000190",
"opening_date": "2020-01-01",
"website": "https://exemplo.com.br"
},
"owner": {
"first_name": "André",
"last_name": "Silva",
"email": "[email protected]",
"phone_number": "(11)999999999",
"cpf": "12345678909",
"birthdate": "1990-01-01"
},
"business_address": {
"line1": "Av Paulista",
"line2": "1000",
"line3": "Sala 10",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zip_code": "01310-100",
"country_code": "BR"
},
"owner_address": {
"line1": "Rua Exemplo",
"line2": "100",
"line3": "Apto 10",
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"zip_code": "01000-000",
"country_code": "BR"
}
}Habilitar cobros
Para permitir payouts al seller, primero tokeniza una cuenta bancaria y después asocia el token devuelto al seller. La cuenta bancaria debe tener la misma titularidad que el seller.
Envía banco, sucursal, cuenta, titularidad y tipo de cuenta.
IOPAY convierte los datos bancarios en un token seguro.
Asocia el token obtenido al io_seller_id.
La cuenta vinculada podrá utilizarse en los flujos de transferencia compatibles.
Tokenizar cuenta bancaria
curl --request POST \
--url https://api.iopay.com.br/api/v1/sellers/bank_accounts/tokenize/:IO_SELLER_ID/:ID_DEV \
--header 'Authorization: Bearer tu_token' \
--header 'Content-Type: application/json' \
--data '{
"holder_name": "ANDRE SILVA",
"bank_code": "341",
"routing_number": "0700",
"account_number": "81929922",
"ein": null,
"taxpayer_id": "12345678909",
"type": "checking"
}'El campo type acepta checking para cuenta corriente o savings para cuenta de ahorro.
Vincular token al seller
curl --request POST \
--url https://api.iopay.com.br/api/v1/sellers/bank_accounts/associate_bank_account/:ID_DEV \
--header 'Authorization: Bearer tu_token' \
--header 'Content-Type: application/json' \
--data '{
"io_seller_id": "<IO_SELLER_ID>",
"token": "<BANK_ACCOUNT_TOKEN>"
}'Reglas operativas
- La Sellers API debe estar habilitada y autorizada por IOPAY para la integración.
- Utiliza autenticación Bearer en las operaciones protegidas.
- Persiste el
io_seller_iddevuelto en el registro. - Valida el tipo de seller antes de utilizar endpoints específicos para persona física o jurídica.
- Vincula una cuenta bancaria de la misma titularidad antes de depender de los payouts.
Collection oficial
Consulta la collection completa de la Sellers API en Postman para acceder a todos los endpoints, ejemplos de solicitud y respuestas disponibles.
Abrir collection en Postman ↗