Saltar al contenido principal

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.

información

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 campoTipoDescripción
payer_emailemailEmail del pagador
payer_ziptextCódigo postal
payer_phonetelTeléfono
payer_cardtextNúmero de tarjeta (usar inputmode="numeric", maxlength="23")
payer_expiryDatetextVencimiento, formato MM/YY
payer_cvvpasswordCVV
payer_nametextNombre 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​

EventoCuándo se disparaPayload
session.onFormReadyEl SDK terminó de inicializar el form—
session.onSuccessEl pago fue exitosoevent.successUrl — redirigir ahí
session.onDeclineEl pago fue rechazadoevent.message — mensaje para mostrar al usuario
session.onInputValidationValidación de un campo en tiempo realevent.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.