curl -X POST "https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link" \
-H "Content-Type: application/json" \
-H "x-api-key: TU_APP_KEY" \
-d '{
"businessId": 92,
"orderId": 272992
}'
Método: POST
URL: https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link
Headers
Content-Type application/json
x-api-key TU_APP_KEY
Body (raw JSON)
{
"businessId": 92,
"orderId": 272992
}
{
"message": "ok"
}
{
"message": "Invalid API key"
}
{
"message": "Internal server error"
}
Ordenes
Enviar Link de Pago
Genera el link de pago de una orden y lo envía al cliente por el canal del chat
POST
/
catalogs
/
orders
/
payment
/
link
curl -X POST "https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link" \
-H "Content-Type: application/json" \
-H "x-api-key: TU_APP_KEY" \
-d '{
"businessId": 92,
"orderId": 272992
}'
Método: POST
URL: https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link
Headers
Content-Type application/json
x-api-key TU_APP_KEY
Body (raw JSON)
{
"businessId": 92,
"orderId": 272992
}
{
"message": "ok"
}
{
"message": "Invalid API key"
}
{
"message": "Internal server error"
}
Genera la URL de pago de una orden (agregando
tid con el transactionId de la orden y oid con el ID de la orden) y la envía como mensaje de texto al contacto del chat asociado a la orden. También registra el evento payment_link_sent en las estadísticas de e-commerce del negocio.
Autenticación
Requiere el encabezadox-api-key con el App Key del negocio. Consulta Autenticación.
Body
number
required
ID del negocio (empresa) dueño de la orden. Se usa para obtener la URL base de pago configurada en
feature_flags["payments-url"].number
required
ID de la orden para la que se generará y enviará el link de pago.
Comportamiento
- Busca la orden (
orderId) y el negocio (businessId); si el negocio no tiene configuradafeature_flags["payments-url"], la generación de la URL fallará. - Toma el chat de la orden y su contacto para saber a quién enviar el mensaje.
- Si la orden aún no tiene
transactionId, genera uno nuevo (UUID v4) y lo guarda en la orden. - Establece
paidExpireen la orden a 2 horas a partir del momento de la solicitud (vencimiento del link). - Construye la URL final agregando los query params
tid(transactionId) yoid(orderId) sobre la URL base de pago del negocio. - Envía la URL como mensaje de texto al contacto por el canal del chat (p. ej. WhatsApp).
- Registra un evento
payment_link_sentenStatsWaEcommerce(no bloquea la respuesta si falla). - No valida el
statusde la orden ni si ya fue pagada: puede reenviarse el link las veces que se necesite, lo que reinicia elpaidExpire.
Existen variantes de este endpoint para otros canales:
POST /catalogs/orders/payment/link/template (envía el link mediante una plantilla de WhatsApp) y POST /catalogs/orders/payment/link/sms (envía el link por SMS).Respuesta
string
"ok" cuando el link se generó y el mensaje se envió correctamente.curl -X POST "https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link" \
-H "Content-Type: application/json" \
-H "x-api-key: TU_APP_KEY" \
-d '{
"businessId": 92,
"orderId": 272992
}'
Método: POST
URL: https://beta.api-iobot-desarrollo.com/catalogs/orders/payment/link
Headers
Content-Type application/json
x-api-key TU_APP_KEY
Body (raw JSON)
{
"businessId": 92,
"orderId": 272992
}
{
"message": "ok"
}
{
"message": "Invalid API key"
}
{
"message": "Internal server error"
}