La funcionalidad de Apple Pay está en fase de pruebas. Solo está disponible para comercios de Chile 🇨🇱, México 🇲🇽, Colombia 🇨🇴 y Perú 🇵🇪, y admite tarjetas Visa y Mastercard.Ten en cuenta que esta funcionalidad puede cambiar sin aviso previo.
initApplePayButton.Jerarquía#
Métodos#
onCancel#
Este evento se dispara cuando el proceso de token de Apple Pay se cancela.Parámetros#
| Nombre | Tipo | Descripción |
|---|
callback | () => void | Función que se ejecuta cuando se cancela el proceso de tokenización. |
Devuelve#
Ejemplo#
La instancia cardApplePay debe estar inicializada antes con initApplePayButton.
onClick#
Este evento se dispara cuando el usuario hace clic en el botón de Apple Pay.Parámetros#
| Nombre | Tipo | Descripción |
|---|
callback | () => void | Función que se ejecuta cuando se hace clic en el botón de Apple Pay. |
Devuelve#
Ejemplo#
La instancia cardApplePay debe estar inicializada antes con initApplePayButton.
requestApplePayToken#
Inicia el flujo de pago con Apple Pay y solicita un token de tarjeta de Kushki.Este token ya viene procesado y listo para usarse en la API de Kushki para hacer un cargo o crear una suscripción.Este método requiere que initApplePayButton se haya inicializado correctamente y que uses una instancia ICardApplePay válida.
Parámetros#
| Nombre | Tipo | Descripción |
|---|
options | ApplePayGetTokenOptions | Opciones de configuración de la solicitud de pago con Apple Pay. |
ApplePayGetTokenOptions fields:| Campo | Tipo | Descripción |
|---|
amount | number | Monto de la transacción. |
countryCode | string | País del comercio (por ejemplo, "BR", "CL", "CO", "CR", "EC", "SV", "GT", "HN", "MX", "NI", "PA", "PE"). |
currencyCode | string | Moneda de la transacción (por ejemplo, "USD", "COP", "CLP", "UF", "PEN", "MXN", "BRL", "CRC", "GTQ", "HNL", "NIO"). |
displayName | string | El nombre del comercio que se muestra en la hoja de Apple Pay. |
isSubscription | boolean (opcional) | Cuando es true, genera un token de suscripción en vez de un token de pago único. Por defecto: false. |
optionalApplePayFields | object (opcional) | Campos adicionales de configuración de Apple Pay según la especificación oficial de Apple. Permite al comercio personalizar la experiencia de checkout (por ejemplo, métodos de envío obligatorios, dirección de facturación, etc.). |
Devuelve#
Promise<AppleTokenResponse> — Una promesa que resuelve con la respuesta del pago tokenizado.Lanza#
| Código | Descripción |
|---|
ERRORS.E025 | Los pagos con Apple Pay no están disponibles. |
ERRORS.E026 | Falla el proceso de token de Apple Pay. |
ERRORS.E027 | Se canceló el proceso de token de Apple Pay. |
Ejemplo — Pago único#
Usa esto cuando necesites un token para hacer un cargo único.Ejemplo — Pago de suscripción#
Envía isSubscription: true para generar un token de suscripción. Ese token se usa para crear un cargo recurrente con la API de suscripciones de Kushki.Ejemplo — Datos de facturación y envío obligatorios#
¿Tienes una sugerencia sobre esta documentación? Contáctanos.
