---
title: "Iniciar una suscripción recurrente anual con dLocal Go (roles owner/admin)"
method: POST
path: "/pagos/suscripcion/checkout"
tags: ["pagos"]
---

# Iniciar una suscripción recurrente anual con dLocal Go (roles owner/admin)

`POST /pagos/suscripcion/checkout`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/pagos/suscripcion/checkout`
- Auth: HTTP bearer

Asegura el Subscription Plan de dLocal para el plan del catálogo (monto = precio anual + IVA 15%, cadencia anual), registra una suscripción pendiente y devuelve el subscribe_url con el external_id. El navegador se redirige a esa URL; la activación del plan ocurre en el webhook del primer cobro, no en el redirect. 503 si dLocal no está configurado.

## Request body

- object
  - `plan` 'emprendedor' | 'pyme' | 'empresa', required

## Response `201`

Suscripción pendiente creada; redirigir el navegador a subscribeUrl

- object
  - `suscripcionId` string, uuid
  - `subscribeUrl` string, uri: URL de dLocal a la que redirigir para completar la suscripción

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `401`: Token/key ausente, inválido o expirado
- `403`: Rol insuficiente o acceso denegado
- `503`: Suscripción en línea no configurada; usar activación manual

---

[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)