Cobra un monto exacto en bolívares (por ejemplo Bs 2.000,00)
Crea una sesión de checkout con amountVes para que al comprador se le pidan exactamente los bolívares que indiques, sin importar la tasa.
Qué vas a hacer
Con amountUsd, el monto en bolívares que ve el comprador es tus dólares × la tasa al momento de pagar, así que casi nunca es redondo (por ejemplo Bs 1.996,33). Si tus precios están en bolívares, envía `amountVes`: Pago Móvil, Débito Inmediato y tarjeta piden exactamente ese monto, sin importar la tasa.
- Tu clave de API en tu servidor.
- Métodos en bolívares (Pago Móvil, Débito Inmediato o tarjeta) activos en tu cuenta.
- El monto en bolívares, con hasta 2 decimales.
Pasos
- Crea la sesión con amountVes
Llama a
POST /v1/checkout/sessionsconamountVes(por ejemplo2000.00) y sinamountUsd. Envía solo uno de los dos. - Guarda la respuesta
La respuesta trae
amountVes: "2000.00"yamountUsd, su valor en dólares a tu tasa Bolívar (BCV o mercado) en este momento.amountUsdes informativo; el cobro siempre esamountVes. - Envíale el url al comprador
Comparte el
urlpor WhatsApp, correo o una redirección. El checkout muestra Bs 2.000,00 para Pago Móvil, Débito Inmediato y tarjeta. - Confirma el pago
Cuando se paga, llega
payment.completedconvesAmount: "2000.00"y tureference. También puedes leer la sesión conGET /v1/checkout/sessions/:id:statuspasa apaid.
curl --request POST "${API_URL}/v1/checkout/sessions" \
--header "content-type: application/json" \
--header "x-api-key: ${VEXPAY_API_KEY}" \
--data '{
"amountVes": 2000.00,
"description": "Pedido #2051",
"reference": "order-2051",
"methods": ["pago_movil", "c2p"]
}'const session = await vexpay.checkout.sessions.create({
amountVes: 2000, // exactamente Bs 2.000,00
description: 'Pedido #2051',
reference: 'order-2051',
methods: ['pago_movil', 'c2p'],
});
// session.amountVes === '2000.00'
// session.amountUsd: '2.18' (2000 a tu tasa)
// Send session.url to the buyer.{
"id": "cs_9f2a4b7c1d3e",
"status": "open",
"url": "https://pay.vexpay.app/pay/cs-9f2a4b7c1d3e",
"amountVes": "2000.00",
"amountUsd": "2.18",
"reference": "order-2051",
"methods": ["pago_movil", "c2p"]
}Bueno saber
- El cobro mínimo y el máximo (US$100.000) se revisan con
amountVesa tu tasa Bolívar al crear la sesión. - USDT y USDC siguen disponibles: el comprador paga Bs ÷ la tasa al momento de pagar, redondeado hacia arriba al céntimo.
- Los pesos colombianos (
cop) no se ofrecen en una sesión con precio en bolívares. amountVesesnullen las sesiones creadas conamountUsd.
Comprueba que funcionó
- Abre el
url: el checkout pide Bs 2.000,00. - En Test, pulsa Simular pago recibido en la pantalla de espera de Pago Móvil: la sesión pasa a
paidy llegapayment.completedconvesAmount: "2000.00".
Si algo sale mal
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
400 invalid_data: "Send exactly one of amountUsd or amountVes" | Enviaste los dos montos, o ninguno | Envía solo amountVes. |
400 invalid_data que menciona cop | Pediste cop en una sesión con precio en bolívares | Quita cop de methods. |
422 amount_below_minimum | amountVes vale menos que tu cobro mínimo | Sube el monto; minimumUsd en el error es el mínimo en dólares. |
503 rate_unavailable | No se pudo leer la tasa Bolívar | Intenta de nuevo en unos minutos. |
Relacionado: Enlace solo Pago Móvil · Verificación de Pago Móvil · Webhooks