Attributes
| Field | Type | Description |
|---|---|---|
seller_id | string (UUID) | The Yuno-generated unique identifier for this seller. |
account_code | string (UUID) | The account under which this seller was created. |
merchant_seller_id | string | The merchant’s own identifier for this franchise store (MAX 255; MIN 1). |
name | string | The seller’s display name (MAX 255). |
email | string | The seller’s email address. |
phone | object | The seller’s phone. Contains country_code and number. |
phone.country_code | string | Phone country code (e.g., "55"). |
phone.number | string | Phone number (e.g., "11999999999"). |
document | object | The seller’s legal document. Contains type and number. |
document.type | string | Document type (e.g., CNPJ, CPF, RUT, NIT). |
document.number | string | Document number (e.g., "12345678000199"). |
address | object | The seller’s address. |
address.street | string | Street name. |
address.number | string | Street number. |
address.city | string | City name. |
address.state | string | State or province code. |
address.country | string | Country code (ISO 3166-1 alpha-2). |
address.zip_code | string | Postal or ZIP code. |
country | string | The seller’s country (ISO 3166-1 alpha-2, MAX 2). |
website | string | The seller’s website URL. |
industry | string | The seller’s industry or business vertical (MAX 255). |
merchant_category_code | string | Merchant Category Code / MCC (MAX 4). |
payment_method | array | Payment method configurations with provider-specific details. |
created_at | timestamp | Creation timestamp (ISO 8601). |
updated_at | timestamp | Last update timestamp (ISO 8601). |
Example Seller Object
{
"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": { "country_code": "55", "number": "11999999999" },
"document": { "type": "CNPJ", "number": "12345678000199" },
"address": {
"street": "Av Paulista",
"number": "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_method": [
{
"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"
}