Activa o desactiva los métodos de pago del checkout
Elige qué métodos ven los compradores en todos tus checkouts alojados desde Portal → Payment methods, o limita un solo enlace con `methods`, y entiende por qué un método está oculto.
Qué vas a hacer
Dos cosas deciden lo que ve un comprador: lo que VEXPay habilitó para tu cuenta y lo que tú encendiste. Tú controlas lo segundo, para todos los checkouts a la vez o por enlace.
Pasos: para todos los checkouts
- Abre Payment methods
En el portal, abre Payment methods. Lista Card, Débito Inmediato, Pago Móvil, USDT, USDC y pesos colombianos, cada uno con la moneda en que se paga.
- Mueve los interruptores
Cada cambio se guarda al instante. Los métodos que VEXPay no habilitó para ti aparecen en gris como "Not enabled for your account".
- Deja al menos uno encendido
El portal no deja apagar el último método habilitado.
- Un método que apagas desaparece de todos los checkouts alojados: enlaces de pago del portal, enlaces de producto y sesiones de checkout de la API.
- Un cambio en Live también se aplica a tu cuenta Test.
- Las llamadas directas a la API de pagos (por ejemplo
POST /v1/payments/vpos) no se ven afectadas.
Pasos: para un solo checkout
Envía methods al crear una sesión de checkout. Valores: c2p (se muestra como Débito Inmediato), pago_movil, vpos (tarjeta), usdt, usdc, cop. Omítelo para ofrecer todo lo que tu cuenta acepta y tiene encendido.
curl --request POST "${API_URL}/v1/checkout/sessions" \
--header "content-type: application/json" \
--header "x-api-key: ${VEXPAY_API_KEY}" \
--data '{ "amountUsd": 50.00, "description": "Pedido #3007", "methods": ["usdt", "usdc"] }'Comprueba que funcionó
En Payment links, cada enlace activo muestra "Buyers can pay with: …" y da una razón por cada método oculto. Abre un checkout en una ventana privada para verlo como lo ve un comprador.
| Razón mostrada | Qué significa | Qué hacer |
|---|---|---|
| not enabled for your account | VEXPay no habilitó el método para tu cuenta | Pide a VEXPay que lo habilite. |
| turned off in Payment methods | Tú lo apagaste | Vuelve a encenderlo. |
| excluded on this link | El methods de la sesión lo deja fuera | Crea una sesión que lo incluya. |
| not available for sellers | Las stablecoins y los pesos no se ofrecen en checkouts divididos con un vendedor | Es lo esperado; los checkouts divididos aceptan solo métodos en bolívares. |
| receiving account not set up | Pago Móvil en Live sin una cuenta receptora completa | Contacta a VEXPay. |
| rate temporarily unavailable | No hay una tasa de cambio reciente en este momento | Espera unos minutos; los demás métodos siguen funcionando. |
| amount below the minimum | El precio en pesos está por debajo de COP 20.000 | Sube el monto o deja que el comprador elija la cantidad. |
| temporarily unavailable | El método no se puede ofrecer en este momento | Reintenta más tarde; contacta a VEXPay si persiste. |
Si algo sale mal
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| 400 "Keep at least one payment method on." | Intentaste apagar el último método habilitado | Enciende otro método primero. |
400 invalid_data "Turned off in Portal → Payment methods: …" | Una sesión menciona un método que apagaste | Quítalo de methods o vuelve a encenderlo. |
| Un interruptor está en gris | No está habilitado para tu cuenta | Pide a VEXPay que lo habilite. |
Relacionado: Enlaces de pago · Checkout embebido