---
title: "Registrar comercio (self-signup público)"
method: POST
path: "/switch/v1/comercios/registrar"
tags: ["Onboarding"]
---

# Registrar comercio (self-signup público)

`POST /switch/v1/comercios/registrar`

## Request

- Base URL: `https://pay.pagaconquickpay.com`
- URL: `https://pay.pagaconquickpay.com/switch/v1/comercios/registrar`
- Auth: none required

Alta pública de un comercio. **No requiere `x-switch-key`.** Nace en estado `pendiente` con `kyc_tier` 0 y emite **una** llave de prueba `sk_test_…` (devuelta una sola vez). Para operar en LIVE, el comercio debe completar KYC y ser aprobado por el administrador.

## Request body

- RegistrarComercioRequest
  - `codigo` string, required: Identificador único del comercio (slug).
  - `nombre` string, required
  - `rif` string, required
  - `contacto` string, required: Correo o teléfono de contacto.

## Response `201`

Comercio creado (incluye `sk_test` una sola vez)

- ComercioRegistrado
  - `codigo` string
  - `estado` 'pendiente'
  - `sk_test` string: Llave de prueba `sk_test_…`. Se devuelve **una sola vez**.

## Other responses

- `400`: Validación
- `409`: Código duplicado

---

[API](https://skmtc.dev/pagaconquickpay/apis/quickpay-api.md) · [All operations](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/revisions/999597fa67f3?raw)