Checkout Page
Es la página que ve el cliente tras la redirección. Contiene los campos necesarios según el método de pago elegido.
Si enviaste email o billing_address en el request, esos campos no se muestran en la Checkout Page (ya los tenés). Si no los enviaste y el método los necesita, se muestran para que el cliente los complete.
Campos y validaciones
| Campo | Tipo | Límite | Error mostrado |
|---|---|---|---|
| Número de tarjeta | Integral | Luhn, 14–19 dígitos | Invalid card number |
| Fecha de expiración | Date | mm/yy, posterior a hoy | The expiration date of card is expired and not valid |
| Código de seguridad | Integral | hasta 4 caracteres | Invalid security code |
| Nombre en la tarjeta | String | máx 32, mínimo 2 palabras | Debe contener nombre y apellido |
| País | List | código 2 letras | Country is required / Please enter a valid Country |
| Estado/Región | String/List* | — | Lista solo para USA, Canadá, Australia, Japón, India |
| Ciudad | String | máx 32 | City is required |
| Dirección | String | máx 32 | Address line is required |
| Código postal | String | máx 32 | Zip code is required |
| Teléfono | String | máx 32 | Phone number is required |
Pre-routing
Para simplificar la elección del método de pago, podés configurar reglas de pre-routing en el panel admin (módulo Custom Routing), que determinan qué métodos son válidos para cada pago — evitando que el cliente elija un método no disponible en su región.
Si el request incluye el array methods, las reglas de pre-routing se ignoran.
Tokenización de tarjeta
Para clientes recurrentes, podés guardar los datos de tarjeta:
- Enviá
req_token: trueen el request de autenticación. - Recibís un
card_tokenen el callback. - En el siguiente request, enviá ese
card_token— el cliente verá los datos anonimizados en el formulario.
Web information
Checkout recolecta información del navegador que usa el cliente. Mientras el cliente está en la Checkout Page, el servicio obtiene datos del sistema operativo, el navegador y el idioma del navegador. Esa información se envía al acquirer en algunos casos, según lo que el método de pago requiera.
Redirect types
| Tipo | Descripción |
|---|---|
| POST redirect | Con parámetros (form POST) o sin parámetros |
| GET redirect | Parámetros en el query string |
| Memory Storage | Ver abajo |
Memory Storage (recomendado)
Se habilita en Configuration → Protocol Mapping → Edit Protocol Mapping → "Use memory storage to save redirect parameters".
Con esto habilitado:
- Los datos de redirección (parámetros, payload, metadata) se guardan del lado del proveedor.
- Se devuelve al merchant una URL simple de redirect.
- El merchant redirige al pagador a esa URL.
- Un wrapper endpoint recupera los datos guardados, arma el form POST y lo auto-envía al merchant.
Link example
{
"redirect_url": "https://checkout.rafinita.com/wrapper/026f9cd4-ec2a-11f0-9a2d-9efd82971246/7e9dc650db39212ea2fda44201207ea3",
"redirect_method": "GET"
}
Example POST redirect
{
"redirect_params": {
"body": "K1o1bGZNMXZGS2RTMlNIYmgzWlExV1hiN3FkcXAyMmlZSDFPZkFsR3czZnRZa1E5b2xYT1ZsZWJncld6YUJJTFJWREdaUDlxQ3QvVWEyY2JBTU9wOWZpd0hXdVdoQXRiVFlrZ3RaOVNZZDZNL2JXTUdyV0NrdDlBaUNQZE5NaXZoTWNkcTlxVURSSkxaTWNEWXJ3aEtHWVdpODNWQzVRWlZWdVpFKzY5aWJjPTo6WjF6NDNkV0R0d1RYYnNneXhWZGEydz09"
},
"redirect_method": "POST"
}
Beneficios:
- Integración mínima (solo un GET redirect, sin armar forms HTML)
- Mayor seguridad (datos sensibles no viajan por query params)
- Sin riesgo de exceder límites de largo de URL (importante para payloads 3DS grandes)
- Menos errores de integración (encoding, parámetros faltantes, auto-submit roto)
Sin Memory Storage, el merchant es responsable de preservar todos los parámetros, renderizar el form correctamente, el auto-submit, y evitar pérdida de datos o problemas de encoding.
Formulario de pago custom
Si preferís tu propio formulario de pago, especificá un identificador único en el request de autenticación:
{ "form_id": "xxxxx-xxxxx-xxxxx" }
Más información en SDK Checkout.
Personalización de la página
Desde el panel admin (Configuration → Branding, solo usuarios autorizados):
- Elegir template de página
- Configurar: ícono de login, color de encabezado, color de fondo, color de botones
- Guardar