El SDK te permite tokenizar la tarjeta de forma similar al API de Card Token con la diferencia de que no necesitas tener certificación PCI ya que no tendrás acceso a la información de la tarjeta de tu cliente, permitiéndote aceptar pagos con tarjeta de manera segura pero conservando el control total de la experiencia de pago en la cuál tus clientes pueden completar una compra sin salir de tu sitio web.
IMPORTANTE
Aunque no necesitas tener una certificación PCI, aún así necesitas verificar tu identidad con Clip para poder consumir el SDK de Checkout Transparente.
Puedes encontrar más información sobre cómo verificar tu identidad aquí.
Flujo
El flujo de pago consiste en los siguientes pasos:
- Usando el SDK, despliegas un formulario (incluido en el SDK) para capturar la información de la tarjeta.
- El SDK capturará la información de la tarjeta y te regresará un token.
- Una vez con el token, desde tu back-end realiza una llamada al endpoint POST /payments de la API de Checkout Transparente para realizar el pago.
Todo esto mientras controlas la experiencia desde tu sitio web.
Toma en cuenta que, aunque tu controlas la experiencia de pago, el formulario para capturar la tarjeta será proporcionado por Clip, esto con el fin de cumplir con las regulaciones PCI.
Este formulario será desplegado dentro de tu sitio web por lo que tus clientes no serán redirigidos a ningún sitio externo:
Autenticación
Para autenticarte en el SDK necesitarás tu API Key.
La API Key se puede generar siguiendo estos pasos:
- Ingresa a tu cuenta Clip.
- Ingresa al "Panel de desarrolladores" ubicado en la última opción del menú de la izquierda.
- Una vez en el panel de desarrollador tendrás acceso a la sección de credenciales.
- Selecciona "Crear credencial" y asígnale un nombre a tus credenciales.
- Copia tu API Key (Clave API). En este caso la clave secreta no es necesaria.
El siguiente es un ejemplo del uso de la API Key para autenticarte en el SDK:
const API_KEY = "dd793cda-5e7b-4521-97bf-a08970de44";
A diferencia del SDK de checkout trannsparente, para completar el pago usando la API de Payments de Clip la autenticación consiste en usar la API Key generada en el ejemplo anterior, agregarle el prefijo "Bearer" y copiarla dentro del parámetro de encabezado o Header llamado: Authorization.
A continuación se muestra un ejemplo de los encabezados en una llamada cURL a la API de payments de Clip mostrando el uso al API Key:
curl --location 'https://api.payclip.com/payments'\
--header 'Authorization: Bearer dd793cda-5e7b-4521-97bf-a08970de44' \
--header 'Content-Type: application/json'
}