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

# Consultar revisión de un comercio

> En qué va el ingreso de un comercio de tu programa de aliado.

Solo para empresas con un [programa de aliado](https://docs.onepay.la/client/companies/partner-program.md), con la **llave del aliado**. Devuelve lo que le falta al comercio para enviarlo a revisión, el estado de la revisión de cumplimiento con las notas del revisor y el estado del alta de su comercio con el procesador de tarjetas, que es lo que lo activa.

Para enterarte de los cambios sin consultar, escucha los [webhooks de empresas](https://docs.onepay.la/client/webhooks/companies.md).

### Parámetros de ruta

**company\_id** `string` *required*

ID del comercio. Una empresa que no es un comercio de tu programa, incluida la tuya, responde `404`.

```bash cURL theme={null}
curl https://api.onepay.la/v1/companies/9da58912-101d-46f8-86c9-20a52119c0bf/review \
  -H "Authorization: Bearer sk_test_KjbE0Vobf5Lg1yNZ4HoKawDItDs3Rod9VXNBWrEYmGn06tkesPIi"
```

```javascript JavaScript theme={null}
const companyId = '9da58912-101d-46f8-86c9-20a52119c0bf';

const response = await fetch(`https://api.onepay.la/v1/companies/${companyId}/review`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_test_KjbE0Vobf5Lg1yNZ4HoKawDItDs3Rod9VXNBWrEYmGn06tkesPIi'
  }
});
const review = await response.json();
console.log(review.status); // Estado del comercio
console.log(review.missing_documents); // Documentos que faltan para enviarlo
```

```python Python theme={null}
import requests

company_id = "9da58912-101d-46f8-86c9-20a52119c0bf"
url = f"https://api.onepay.la/v1/companies/{company_id}/review"
headers = {
    "Authorization": "Bearer sk_test_KjbE0Vobf5Lg1yNZ4HoKawDItDs3Rod9VXNBWrEYmGn06tkesPIi"
}

response = requests.get(url, headers=headers)
review = response.json()
print(review["status"])  # Estado del comercio
print(review["missing_documents"])  # Documentos que faltan para enviarlo
```

```php PHP theme={null}
<?php
$companyId = "9da58912-101d-46f8-86c9-20a52119c0bf";
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.onepay.la/v1/companies/{$companyId}/review",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_KjbE0Vobf5Lg1yNZ4HoKawDItDs3Rod9VXNBWrEYmGn06tkesPIi"
    ]
]);

$response = curl_exec($ch);
$review = json_decode($response, true);

echo $review["status"]; // Estado del comercio
print_r($review["missing_documents"]); // Documentos que faltan para enviarlo

curl_close($ch);
?>
```

### Response

**id** `string`

ID del comercio.

**status** `string`

Estado del comercio:

* `pending`: recién creado, o devuelto con un pedido de cambios. Es el único estado desde el que se envía a revisión.
* `onboarding`: en revisión, o aprobado y a la espera de que el procesador de tarjetas registre su comercio.
* `active`: puede cobrar.
* `in_active`: rechazado o suspendido.

**missing\_documents** `array`

Documentos que faltan para enviar el ingreso: `rut`, `ccc`, `dni` o `bank`. A una persona jurídica se le piden los cuatro; a una persona natural, `rut` y `dni`. En un comercio creado por el API llega vacío, porque [Crear empresa](https://docs.onepay.la/client/companies/create.md) ya los exige.

**missing\_fields** `array`

Datos del perfil que faltan para enviarlo: `legal_name` (solo persona jurídica) o `document_number`. También llega vacío en un comercio creado por el API.

**review** `object | null`

La revisión de cumplimiento. `null` mientras el ingreso no se ha enviado.

**Propiedades**

**review\.status** `string`

`draft`, `submitted`, `changes_requested`, `approved` o `rejected`.

**review\.notes** `string | null`

Las notas del revisor. Solo vienen con `changes_requested` o `rejected`: dicen qué corregir.

**review\.submitted\_at** `string | null`

Cuándo se envió (ISO 8601).

**review\.reviewed\_at** `string | null`

Cuándo decidió el revisor (ISO 8601).

**processor** `object | null`

El alta del comercio con el procesador de tarjetas. `null` hasta que cumplimiento aprueba el ingreso.

**Propiedades**

**processor.status** `string`

`pending` mientras se da de alta, `registered` cuando quedó dado de alta (en ese momento el comercio pasa a `active` y sale `company.verified`) o `failed` si no se pudo.

**processor.error** `string | null`

El motivo, cuando `status` es `failed`. OnePay recibe un aviso y retoma el alta.

* Si el procesador rechaza el alta, es el mensaje que devuelve. Dice qué dato corregir y puede estar en inglés, por ejemplo «phone is required» o «Invalid city». Si no trae mensaje, es «El procesador rechazó el alta del comercio.».
* «El procesador no pudo procesar el alta; OnePay la retoma.» quiere decir que falló la conexión con el procesador, no los datos del comercio. No hay nada que corregir.
* Otros motivos: «A la empresa le falta: … El procesador no da de alta el comercio sin esos datos.», «El procesador no confirmó el alta del comercio.» o «El alta con el procesador no se completó después de 5 intentos.».

**processor.at** `string`

Cuándo cambió el estado (ISO 8601).

```json 200 Con cambios pedidos theme={null}
{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "status": "pending",
  "missing_documents": [],
  "missing_fields": [],
  "review": {
    "status": "changes_requested",
    "notes": "El RUT está vencido. Carga uno expedido en los últimos 30 días.",
    "submitted_at": "2026-11-17T15:10:00.000000Z",
    "reviewed_at": "2026-11-18T14:22:00.000000Z"
  },
  "processor": null
}
```

```json 200 Aprobado, esperando el registro theme={null}
{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "status": "onboarding",
  "missing_documents": [],
  "missing_fields": [],
  "review": {
    "status": "approved",
    "notes": null,
    "submitted_at": "2026-11-18T16:05:00.000000Z",
    "reviewed_at": "2026-11-19T10:30:00.000000Z"
  },
  "processor": {
    "status": "pending",
    "error": null,
    "at": "2026-11-19T10:30:01+00:00"
  }
}
```

```json 200 Sin enviar theme={null}
{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "status": "pending",
  "missing_documents": [],
  "missing_fields": [],
  "review": null,
  "processor": null
}
```

```json 404 theme={null}
{
  "message": "Registro no encontrado, Compañía no existe",
  "code": 10002,
  "code_name": "record_not_found"
}
```


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