---
title: "Pagar (enviar dinero)"
method: POST
path: "/switch/v1/pagar"
tags: ["Pagos"]
---

# Pagar (enviar dinero)

`POST /switch/v1/pagar`

## Request

- Base URL: `https://pay.pagaconquickpay.com`
- URL: `https://pay.pagaconquickpay.com/switch/v1/pagar`
- Auth: API key in header `x-switch-key`

Envía dinero a un beneficiario por teléfono o cuenta. El riel lo elige `via`: `credito_inmediato` (CCE, **riel por defecto**; admite teléfono o cuenta de cualquier banco, sin afiliación a pago móvil, liquida en el acto → LIQUIDADA) o `pago_movil` (P2P por teléfono, auxiliar opt-in, instantáneo → LIQUIDADA). A cuenta siempre es crédito inmediato.

## Request body

- PagarRequest
  - `idempotency_key` string, uuid, required
  - `monto` object, required
    - `valor` number, required
    - `moneda` string
  - `concepto` string, required
  - `canal` 'boton_pago' | 'billetera_digital' | 'pos' | 'merchant' | 'vpos' | 'whatsapp'
  - `origen_ip` string
  - `banco_preferido` string
  - `ordenante` object, required
    - `tipo` 'cuenta' | 'telefono', required
    - `valor` string, required
    - `banco` string, required
    - `identificacion` string, required
    - `tipo_doc` 'V' | 'E' | 'J' | 'P' | 'G'
    - `nombre` string, required
  - `beneficiario` object, required
    - `tipo` 'cuenta' | 'telefono', required
    - `valor` string, required
    - `banco` string, required
    - `identificacion` string, required
    - `tipo_doc` 'V' | 'E' | 'J' | 'P' | 'G'
    - `nombre` string, required
  - `proposito` 'transferencia' | 'nomina' | 'proveedor'
  - `via` 'credito_inmediato' | 'pago_movil'

## Response `200`

Resultado del pago

- Resultado
  - `id` string, required
  - `estado` 'ACEPTADA' | 'PENDIENTE' | 'LIQUIDADA' | 'RECHAZADA' | 'ERROR' | 'DESCONOCIDA' | 'ANULADA', required
  - `referencia_banco` string, nullable, required
  - `endtoend` string, nullable
  - `motivo_rechazo` 'SALDO_INSUFICIENTE' | 'OTP_INVALIDO' | 'CUENTA_NO_EXISTE' | 'CUENTA_BLOQUEADA' | 'CUENTA_NO_DEBITO' | 'CUENTA_NO_CREDITO' | 'MONTO_INVALIDO' | 'EXCEDE_LIMITE' | 'BENEFICIARIO_NO_COINCIDE' | 'NO_AFILIADO_SERVICIO' | 'BANCO_NO_DISPONIBLE' | 'DUPLICADA' | 'FUERA_DE_HORARIO' | 'CANCELADA_POR_PAGADOR' | 'PENDIENTE_BCV' | 'RECHAZO_TECNICO' | 'FIRMA_AUTH' | 'NO_SOPORTADO' | 'BLOQUEO_RIESGO' | 'NETO_NEGATIVO' | 'KYC_INSUFICIENTE' | 'COMERCIO_NO_ACTIVO' | 'SIN_CUENTA_LIQUIDACION' | 'ANULACION_RECHAZADA' | 'SIN_DEBITO_EN_EXTRACTO' | 'DESCONOCIDO', nullable
  - `intentos` integer
  - `simulado` boolean

## Other responses

- `400`: Validación
- `401`: No autorizado

---

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