SDK Checkout
Si preferís usar tu propio formulario de pago en vez de la Checkout Page hosteada, el SDK te permite montar un formulario custom en tu sitio y manejar el ciclo de vida del pago con JavaScript.
Recordá enviar el form_id correspondiente en el request de autenticación para que Checkout sepa que debe usar tu formulario.
Script del SDK
<script src="https://checkout.rafinita.com/sdk/pay-session.js"></script>
Inicialización
const config = {
formName: "paymentForm", // id del <form> en tu HTML
validateOnInput: false // validar mientras el usuario escribe
};
const session = new PaySession(config);
session.begin();
Estructura del formulario
El SDK detecta los campos del formulario por su id. Los campos esperados son:
| ID del campo | Tipo | Descripción |
|---|---|---|
payer_email | email | Email del pagador |
payer_zip | text | Código postal |
payer_phone | tel | Teléfono |
payer_card | text | Número de tarjeta (usar inputmode="numeric", maxlength="23") |
payer_expiryDate | text | Vencimiento, formato MM/YY |
payer_cvv | password | CVV |
payer_name | text | Nombre del titular |
<form id="paymentForm" class="card-method-form">
<input id="payer_email" type="email" name="email" placeholder="Email" required>
<input id="payer_zip" type="text" placeholder="Zip code" required>
<input id="payer_phone" type="tel" name="phone" placeholder="Phone number" required>
<input id="payer_card" type="text" inputmode="numeric" maxlength="23" placeholder="0000 0000 0000 0000" required>
<input id="payer_expiryDate" type="text" maxlength="5" placeholder="MM/YY" required>
<input id="payer_cvv" type="password" minlength="3" maxlength="4" placeholder="CVV" required>
<input id="payer_name" required minlength="3" maxlength="22" placeholder="Full Name">
<button id="submit" type="submit">Pay</button>
<div id="googlepay-container"></div>
<div id="applepay-container">
<div class="applepay-button" onclick="handleApplePayClick()"></div>
</div>
</form>
Eventos del ciclo de vida
| Evento | Cuándo se dispara | Payload |
|---|---|---|
session.onFormReady | El SDK terminó de inicializar el form | — |
session.onSuccess | El pago fue exitoso | event.successUrl — redirigir ahí |
session.onDecline | El pago fue rechazado | event.message — mensaje para mostrar al usuario |
session.onInputValidation | Validación de un campo en tiempo real | event.inputId, event.result ("error" o válido) |
session.onDecline = function (event) {
document.querySelector(".decline-message").innerText = event.message;
};
session.onSuccess = function (event) {
location.href = event.successUrl;
};
session.onFormReady = function () {
document.querySelector(".form-wrapper").classList.add("show");
};
session.onInputValidation = function (event) {
const input = document.getElementById(event.inputId);
const errorEl = document.getElementById(event.inputId + "Error");
if (event.result === "error") {
input?.classList.add("text-field--error");
errorEl?.classList.add("display-error");
} else {
input?.classList.remove("text-field--error");
errorEl?.classList.remove("display-error");
}
};
Card tokens (tarjetas guardadas)
Si el cliente tiene tarjetas tokenizadas (ver tokenización), el SDK las expone así:
const cardTokens = session.getCardTokens();
// cardTokens: [{ token, brand, last, month, year }, ...]
Para usar un token guardado en el pago actual:
session.setCardToken(token.token);
Para deseleccionar el token y volver a habilitar los campos manuales:
session.clearCardToken();
Apple Pay
El botón de Apple Pay se dispara manualmente:
function handleApplePayClick() {
session.beginApplePay();
}
Google Pay
El SDK inyecta el botón de Google Pay directamente en el contenedor #googlepay-container — no requiere lógica adicional de tu parte más allá de tener el <div> presente en el DOM.