> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

# The Seller Object

> Detailed reference for the Seller object attributes.

The Seller object represents a franchise seller mapping with per-provider merchant credentials.

## 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

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "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"
}
```