Atributos
| Campo | Tipo | Descripción |
|---|---|---|
seller_id | string (UUID) | El identificador único de este vendedor, generado por Yuno. |
account_code | string (UUID) | La cuenta bajo la cual se creó este vendedor. |
merchant_seller_id | string | El identificador propio del comercio para esta tienda de franquicia (MAX 255; MIN 1). |
name | string | El nombre visible del vendedor (MAX 255). |
email | string | La dirección de email del vendedor. |
phone | object | El teléfono del vendedor. Contiene code y number. |
phone.code | string | Código de país del teléfono (por ejemplo, "55"). |
phone.number | string | Número de teléfono (por ejemplo, "11999999999"). |
document | object | El documento legal del vendedor. Contiene type y number. |
document.type | string | Tipo de documento (por ejemplo, CNPJ, CPF, RUT, NIT). |
document.number | string | Número de documento (por ejemplo, "12345678000199"). |
address | object | La dirección del vendedor. |
address.line_1 | string | Nombre de la calle. |
address.line_2 | string | Número de la calle. |
address.city | string | Nombre de la ciudad. |
address.state | string | Código del estado o la provincia. |
address.country | string | Código de país (ISO 3166-1 alpha-2). |
address.zip_code | string | Código postal. |
country | string | El país del vendedor (ISO 3166-1 alpha-2, MAX 2). |
website | string | La URL del sitio web del vendedor. |
industry | string | La industria o vertical de negocio del vendedor (MAX 255). |
merchant_category_code | string | Código de categoría del comercio / MCC (MAX 4). |
payment_methods | array | Configuraciones de método de pago con detalles específicos de cada proveedor. |
created_at | timestamp | Marca de tiempo de creación (ISO 8601). |
updated_at | timestamp | Marca de tiempo de la última actualización (ISO 8601). |
Ejemplo de objeto vendedor
{
"seller_id": "f7a1b2c3-d4e5-6789-abcd-ef0123456789",
"account_code": "11111111-2222-3333-4444-555555555555",
"merchant_seller_id": "FRANCHISE_STORE_001",
"name": "Franchise Store São Paulo",
"email": "store001@franchise.com",
"phone": { "code": "55", "number": "11999999999" },
"document": { "type": "CNPJ", "number": "12345678000199" },
"address": {
"line_1": "Av Paulista",
"line_2": "1000",
"city": "São Paulo",
"state": "SP",
"country": "BR",
"zip_code": "01310-100"
},
"country": "BR",
"website": "https://store001.franchise.com",
"industry": "QSR",
"merchant_category_code": "5812",
"payment_methods": [
{
"payment_method_type": "CARD",
"detail": {
"card": {
"provider": {
"id": "CIELO",
"merchant_id": "CIELO_CC_12345"
}
}
}
},
{
"payment_method_type": "APPLE_PAY",
"detail": {
"wallet": {
"provider": {
"id": "APPLE_PAY",
"merchant_id": "APPLE_PAY_12345",
"payment_processing_key": "<base64-encoded .pem content>",
"payment_processing_certificate": "<base64-encoded .pem content>",
"merchant_identity_key": "<base64-encoded .pem content>",
"merchant_identity_certificate": "<base64-encoded .pem content>",
"merchant_identity_password": "password123"
}
}
}
}
],
"created_at": "2026-03-13T10:00:00Z",
"updated_at": "2026-03-13T10:00:00Z"
}