Guía para desarrolladores
Referencia de API
Explorar documentación

Productos y enlaces de pago sin código

Crea productos y enlaces de pago compartibles para el checkout alojado en /pay/:slug. El comprador paga por C2P contra tu tenant; la comisión de VEX Pay se captura como PLATFORM_FEE al completarse el pago.

Endpoints

MétodoRutaPropósito
POST/v1/productsCrea un producto (name, priceUsd; opcional description / imageUrl / active).
GET/v1/productsLista productos (paginación por cursor; ?active=true|false).
GET/v1/products/:idObtiene un producto y sus enlaces de pago.
PATCH/v1/products/:idActualiza campos — envía solo lo que cambia; "" limpia description / imageUrl.
DELETE/v1/products/:idElimina el producto y sus enlaces. 409 product_has_sales si hubo un checkout pagado.
POST/v1/products/:id/linksCrea un enlace de pago. Omite slug para autogenerarlo desde el nombre.
GET/v1/products/:id/linksLista los enlaces de un producto.
GET/v1/payment-links/:idObtiene un enlace de pago.
PATCH/v1/payment-links/:idActiva/desactiva (status), allowQuantity, maxQuantity / redirectUrl.
DELETE/v1/payment-links/:idElimina un enlace. 409 product_has_sales si un checkout fue pagado — desactívalo.
Crear un productobash
curl --request POST "${API_URL}/v1/products" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "name": "Camiseta VEXPay", "priceUsd": "20.00" }'
Crear un enlace de pagobash
curl --request POST "${API_URL}/v1/products/PRODUCT_ID/links" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "allowQuantity": true, "maxQuantity": 5 }'