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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# El objeto Seller

> Referencia detallada de los atributos del objeto vendedor.

El objeto vendedor representa un mapeo de vendedor de franquicia con credenciales de comercio por proveedor.

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.