Cómo identificar cada venta con una referencia

Para qué sirve

Si compartes el mismo link con muchas personas, la referencia te dice a qué pedido corresponde cada venta. Toda venta trae una referencia única.

Usar tu propia referencia

Agrega ?reference= al final de tu link de pago con tu propio identificador (número de pedido, id de cliente, SKU):

https://www.vexorpay.com/p/a1b2c3d4e5?reference=ORD-1001

La venta que salga de esa visita queda con la referencia ORD-1001. Admite hasta 200 caracteres.

Si creas el checkout por API (POST /api/v1/payment-links/{id}/checkout), manda el campo reference en el body.

Sin referencia propia

vexorpay genera una sola para esa compra, con el formato VXP- más 12 caracteres (por ejemplo, VXP-7KQ4M9TZ2HXA). Cada visita al link genera una nueva, así que dos ventas nunca quedan con la misma.

Suscripciones

En una suscripción, la referencia queda en la suscripción y cada renovación la hereda.

Dónde aparece

• En la API, en el campo reference de cada venta (GET /api/v1/orders). También puedes buscar una venta por su referencia: GET /api/v1/orders?reference=ORD-1001.
• En los webhooks de cada venta, en data.object.reference.
• En el historial de eventos (GET /api/v1/events).

No confundir con la referencia del link (la que se carga al crear el link): esa es la misma para todas sus ventas y se consulta en el link (GET /api/v1/payment-links/{id}).

UTM

El link también acepta utm_source, utm_medium, utm_campaign, utm_content y utm_term: quedan guardados en la metadata de la venta.

Más detalle en la documentación de ventas y en Notificaciones con webhooks.