Ambientes y pruebas

​

Cómo se comporta el ambiente de test

• Toda operación que crees se acepta y llega a completed a los pocos segundos (default ~10s), disparando los mismos webhooks que live.
• Los valores mágicos fuerzan cada resultado alternativo, para que pruebes tu manejo de errores sin adivinar.

​

Valores mágicos

​

QRs PIX de ejemplo (payout QR Brasil)

00020126360014br.gov.bcb.pix0114+5511998765432520400005303986540575.005802BR5913LOJA DA MARIA6009SAO PAULO62110507PED423163040BF9

00020126380014br.gov.bcb.pix0116loja@example.com5204000053039865802BR5913LOJA DA MARIA6009SAO PAULO62070503***63045EFE

00020126360014br.gov.bcb.pix0114+5511998765432520400005303986540580.995802BR5913LOJA DA MARIA6009SAO PAULO62110507PEDFAIL63045211

​

Qué difiere de live

• Ningún dinero, tarjeta, email ni SMS real sale jamás del ambiente de test.
• Las cuentas nacen verificadas: toda cuenta nueva de test parte con kyc_status: approved, así puedes ejercitar todos los productos de inmediato — sin gate de onboarding. En live las cuentas nacen sin verificar y deben completar su KYC/KYB antes de que salga dinero.
• Las cuentas nacen pobladas: toda cuenta nueva de test parte con ~6 meses de historia demo realista de todos los productos (payouts, payins, transfers, crypto, swaps, tarjetas, banking, contactos…), con saldos, cartola conciliada y analytics listos para explorar — puedes construir dashboards y reportes antes de crear una sola operación.
• Los catálogos de bancos son ficticios (Simulated National Bank, …).
• Las tasas FX son reales (misma fuente que live), así los montos se ven realistas.
• Los datos de test son totalmente independientes de live: nada se copia desde producción. Trata el dataset de test como desechable.

​

Modo test desde el dashboard

​

Probar webhooks en desarrollo local

# Instala cloudflared y expone tu puerto local
cloudflared tunnel --url http://localhost:3000
# → https://<random>.trycloudflare.com  ← úsala como callback_url

ngrok http 3000
# → https://<random>.ngrok-free.app  ← úsala como callback_url

curl -X POST https://cryptobank.qbank.cl/platform/v1/webhooks/subscriptions \
  -H "X-API-Key: pk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "payin_credited",
    "callback_url": "https://tu-tunel.trycloudflare.com/webhooks/cbpay",
    "secret": "un-secreto-largo-y-aleatorio"
  }'

​

Ejercitar cada flujo en test

​

Checklist de go-live

• Cambia la base URL a https://api.qbank.cl/platform y la key a tu pk_... de live (emitida en modo live).
• Las API keys viven en un secrets manager (nunca en el frontend ni en el repo).
• Toda operación de dinero envía un idempotency_key derivado de TU id interno (no un UUID aleatorio por intento).
• Ante timeout o 5xx no reintentas con una key nueva: repite con la misma key o consulta el estado con el GET.
• Verificas la firma HMAC de cada webhook y respondes 2xx rápido (procesa async).
• Manejas los estados no finales (pending, processing) sin asumir éxito — en live la liquidación tarda más que los 10 segundos simulados.
• Re-creaste tus suscripciones de webhook en live (las de test no se traspasan).
• Consultas GET /v1/services para mostrar solo productos habilitados — ver servicios.
• Concilias a diario con GET /v1/movements o la cartola.
• Tienes un canal con el equipo CBPay para depósitos unassigned o incidentes.