Tu primer cobro en 5 minutos

Cuatro pasos con tu llave de prueba: no se mueve dinero real.

1. Saca tu llave de prueba

En tu portal ve a Integraciones › Llaves de API › Crear llave, elige Prueba y copia el valor. Tiene esta forma:

tu-comercio:sk_test_…

Guárdala en una variable:

bash

export QP_KEY="tu-comercio:sk_test_…"

2. Crea un enlace de pago

bash

curl -s https://pay.pagaconquickpay.com/switch/v1/links \
  -H "x-switch-key: $QP_KEY" \
  -H "content-type: application/json" \
  -d '{ "monto": 150, "concepto": "Pedido #1024", "metadata": { "pedido": "1024" } }'

Te devuelve, entre otros campos:

json

{
  "id": "3f6c2a9e-8b1d-4c7a-9e2f-5a1b7c3d9e40",
  "url": "https://pay.pagaconquickpay.com/l/3f6c2a9e-8b1d-4c7a-9e2f-5a1b7c3d9e40",
  "estado": "pendiente",
  "mode": "test"
}

3. Págalo

Abre la url. Como es un cobro de prueba, la página te lo indica y acepta cualquier clave de 8 dígitos (para forzar un rechazo o un pago en proceso: Modo prueba): elige un banco, escribe un teléfono y una cédula de ejemplo (04141234567, V12345678) y paga.

4. Confirma que está pagado

bash

curl -s https://pay.pagaconquickpay.com/switch/v1/links/3f6c2a9e-8b1d-4c7a-9e2f-5a1b7c3d9e40 \
  -H "x-switch-key: $QP_KEY"

"estado": "pagado". Listo: ese es el ciclo completo.

Y ahora, el porqué

Qué significa cada estado → Estados de un cobro
Enterarte sin consultar → Webhooks
Todos los campos del enlace → Enlaces de pago
Cuando quieras cobrar de verdad → Pasar a producción