Receta: acepta pesos colombianos

Permite que compradores en Colombia paguen con Bre-B, Nequi o Daviplata (en el checkout o desde tus propias pantallas) y retén, reembolsa o convierte los pesos.

Dos formas de cobrar pesos

Forma	Ideal cuando	Cómo
Checkout alojado	Ya usas sesiones de checkout o enlaces	Agrega "cop" a methods (o deja methods vacío)
API directa	Construyes tu propia pantalla de pago	POST /v1/cop/payments con un channel

Los pesos tienen su propio saldo, separado de los bolívares y las stablecoins. La comisión estándar es 4,5% + COP 1.500 por pago, con un mínimo de COP 20.000.

Paso 01

Cobra desde tu propia pantalla

Bre-B (curl)bash

curl --request POST "${API_URL}/v1/cop/payments" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --header "Idempotency-Key: order-1042" \
  --data '{ "amountCop": 100000, "channel": "breb", "reference": "order-1042" }'

channel	Qué hace el comprador	Qué muestras
breb	Escanea un QR o pega una llave de transferencia en la app de su banco	next.qrPngBase64 y next.transferKey (solo en esta respuesta)
nequi	Aprueba una notificación push en Nequi	Una pantalla de espera
daviplata	Escribe el código SMS que le envía Daviplata	Un campo para el código; envíalo a POST /v1/cop/payments/:id/otp

Paso 02

Después del pago

Entrega el pedido
payment.completed trae amountCop y feeCop. Identifica el pedido con reference.
Retención
Los pesos quedan retenidos 24 h: GET /v1/cop/balance muestra availableCop, heldCop y nextReleaseAt.
Reembolsa si hace falta
POST /v1/cop/payments/:id/refund dentro de las 96 horas. El reembolso de una venta que sigue retenida sale de lo retenido.
Convierte o retira
Convierte pesos a USDT (POST /v1/conversions con sourceCurrency COP, o convierte automáticamente una parte de cada pago), o pide a VEX Pay un payout bancario de tus pesos disponibles.