API — Links de Pago
POST
Crear link con redirección
Genera un link de pago desde tu backend. El cliente es redirigido automáticamente al checkout al acceder al link.
POST
https://merchant.paymentsway.co/link-de-pago/createEnvía tu Api_key en el header Authorization.
Parámetros
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
merchant_id | string | Merchant ID. | Sí |
form_id | string | Form ID. | Sí |
terminal_id | string | Terminal ID. | Sí |
order_number | string | Referencia única de la transacción. | Sí |
amount | number | Monto de la transacción. | Sí |
currency | string | COP, USD o EUR. | Sí |
order_description | string | Descripción de la compra. | Sí |
client_email | string | Email del cliente. | No |
client_phone | string | Teléfono del cliente. | No |
response_url | string | URL de retorno tras el pago. | No |
additional_data | object | Datos extra que se retornan en el webhook. | No |
checksum | string | Firma de seguridad SHA-256. | No |
Ejemplo de petición
const response = await fetch("https://merchant.paymentsway.co/link-de-pago/create", {
method : 'POST',
headers: {
"Authorization": "TU_API_KEY",
"Content-Type" : "application/json"
},
body: JSON.stringify({
"merchant_id" : 7890,
"form_id" : "",
"terminal_id" : "",
"order_number" : "ORD-456789",
"amount" : 55000,
"currency" : "COP",
"order_description": "Compra de productos",
"client_email" : "cliente@example.com",
"response_url" : "https://example.com/gracias",
})
});
const data = await response.json();
console.log(data);Errores
{ "error": true, "data": "" }VTEX
VTEX es la plataforma de comercio digital líder en Latinoamérica, utilizada por grandes marcas y retailers para gestionar sus tiendas en línea con alto volumen de transacciones. Con el conector nativo de PaymentsWay puedes activar Visa, Mastercard y PSE en tu tienda VTEX en tres pasos simples — sin desarrollo, sin código, en menos de 15 minutos.
POSTCrear link
Genera un link de pago sin redirección automática. El cliente accede manualmente al link.