---
title: "Canjear la primera partner key (self-serve, empresa)"
method: POST
path: "/partners/canjear-key"
tags: ["partners"]
---

# Canjear la primera partner key (self-serve, empresa)

`POST /partners/canjear-key`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/partners/canjear-key`
- Auth: none required

**Requiere el programa OEM activo** (`OEM_HABILITADO=true`; sin la variable, 404). Alta de partners por aprobación manual del operador.

La empresa canjea el token de un solo uso que le entregó el operador tras aprobarla; la partner key `cdop_` se genera en este momento y se devuelve UNA sola vez. Rate-limit por IP. 400 si el token es inválido, ya se usó o expiró; 409 si el partner ya no está activo.

## Request body

- object
  - `token` string, required: Token de canje (cdct_...)

## Response `201`

Partner key creada (se muestra una sola vez)

- object
  - `id` string, uuid
  - `nombre` string
  - `prefijo` string
  - `roles` string[]
  - `aprovisionar` boolean
  - `key` string: La key cdop_ en claro; no se vuelve a mostrar

## Other responses

- `400`: Token inválido, usado o expirado
- `409`: El partner no está activo
- `429`: Demasiadas solicitudes desde esta IP

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)