Web Checkout
Botón de Pago
El botón de pago es un formulario HTML que envías desde tu servidor hacia el checkout de PaymentsWay con los datos de la compra ya precargados. El cliente llega al checkout listo para pagar — tú controlas los datos, PaymentsWay gestiona el cobro.
Solo un formulario HTML POST. Funciona con cualquier tecnología.
Nombre, email, monto y referencia llegan listos al checkout.
Al finalizar el pago el cliente regresa a tu página.
Firma SHA-256 para validar la integridad de los datos.
¿Cómo funciona?
Código base
<form method="Post" action="https://merchant.paymentsway.co/cartaspago/redirect">
<input name="merchant_id" type="hidden" value="0">
<input name="form_id" type="hidden" value="0">
<input name="terminal_id" type="hidden" value="0">
<input name="order_number" type="hidden" value="0">
<input name="amount" type="hidden" value="0">
<input name="currency" type="hidden" value="COP">
<input name="order_description" type="hidden" value="Test de compra">
<input name="client_email" type="hidden" value="user@example.com">
<input name="client_phone" type="hidden" value="3000000000">
<input name="client_firstname" type="hidden" value="Juan">
<input name="client_lastname" type="hidden" value="Pérez">
<input name="client_doctype" type="hidden" value="4">
<input name="client_numdoc" type="hidden" value="1234567890">
<input name="response_url" type="hidden" value="https://tu-sitio.com/respuesta">
<input name="Submit" type="submit" value="Pagar">
</form>Parámetros
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
merchant_id | number | ID del comercio. Encuéntralo en Mis Credenciales. | Sí |
form_id | number | ID del botón de pago. | Sí |
terminal_id | number | ID de la terminal. | Sí |
order_number | string | Referencia única de la venta. | Sí |
amount | number | Monto total en la moneda indicada. | Sí |
currency | string | COP, USD o EUR. | Sí |
order_description | string | Descripción de la venta. | Sí |
client_email | string | Correo electrónico del cliente. | Sí |
client_phone | string | Número de celular del cliente. | Sí |
client_firstname | string | Nombre del cliente. | Sí |
client_lastname | string | Apellidos del cliente. | Sí |
client_doctype | number | Tipo de documento: 1 Pasaporte · 4 CC · 5 CE · 6 NIT. | Sí |
client_numdoc | string | Número de documento. | Sí |
response_url | string | URL a la que redirige tras el pago. | No |
checksum | string | Firma SHA-256 de seguridad. | No |
additional_data | string | Datos adicionales que se retornan en el webhook. | No |
Links de pago
Un link de pago es una URL que puedes generar desde la consola de PaymentsWay o vía API y compartir por cualquier canal digital. El cliente hace clic, ingresa sus datos de pago y listo — sin que tengas que instalar nada en tu sitio web.
Botón de pago abierto
El botón de pago abierto es una variación del botón estándar donde el cliente elige cuánto pagar. Tú defines un rango de montos y él decide. Ideal para donaciones, recargas, propinas o cualquier cobro donde el precio no es fijo.