Saltar al contenido principal

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.

información

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​

CampoTipoLímiteError mostrado
Número de tarjetaIntegralLuhn, 14–19 dígitosInvalid card number
Fecha de expiraciónDatemm/yy, posterior a hoyThe expiration date of card is expired and not valid
Código de seguridadIntegralhasta 4 caracteresInvalid security code
Nombre en la tarjetaStringmáx 32, mínimo 2 palabrasDebe contener nombre y apellido
PaísListcódigo 2 letrasCountry is required / Please enter a valid Country
Estado/RegiónString/List*—Lista solo para USA, Canadá, Australia, Japón, India
CiudadStringmáx 32City is required
DirecciónStringmáx 32Address line is required
Código postalStringmáx 32Zip code is required
TeléfonoStringmáx 32Phone 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.

aviso

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:

  1. Enviá req_token: true en el request de autenticación.
  2. Recibís un card_token en el callback.
  3. 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​

TipoDescripción
POST redirectCon parámetros (form POST) o sin parámetros
GET redirectParámetros en el query string
Memory StorageVer abajo

Memory Storage (recomendado)​

Se habilita en Configuration → Protocol Mapping → Edit Protocol Mapping → "Use memory storage to save redirect parameters".

Con esto habilitado:

  1. Los datos de redirección (parámetros, payload, metadata) se guardan del lado del proveedor.
  2. Se devuelve al merchant una URL simple de redirect.
  3. El merchant redirige al pagador a esa URL.
  4. 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)
aviso

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):

  1. Elegir template de página
  2. Configurar: ícono de login, color de encabezado, color de fondo, color de botones
  3. Guardar