Conectar Checkout.com
Cobra con tarjeta de crédito y débito a través de tu cuenta Checkout.com, con suscripciones, order bump y upsell en 1 clic.
Checkout.com procesa tarjetas de crédito y débito para cuentas abiertas en cerca de 60 países de Europa, las Américas, Oriente Medio y Asia-Pacífico. Conectada a Vipter, atiende ventas únicas, suscripciones, order bump y upsell en 1 clic. Checkout.com no hace PIX ni cuotas a través de Vipter.
Antes de empezar
- Una cuenta Checkout.com. Para probar antes, sirve una cuenta sandbox.
- Acceso al panel de Checkout.com con permiso para crear claves de API y webhooks.
- El rol Admin o Dueño en el proyecto de Vipter.
- Espacio en tu plan para una conexión activa más. La pantalla de proveedores muestra cuántas ya usas.
Paso 1: copiar los datos de la cuenta en Checkout.com
Vipter pide tres datos de tu cuenta. Copia los tres del mismo entorno: todos del sandbox para probar, o todos de producción para vender.
- Clave secreta: en el panel de Checkout.com abre DevelopersKeys y crea una clave de API. La clave secreta del sandbox empieza con
sk_sbox_y la de producción consk_. Solo aparece una vez: cópiala en el momento. - ID del canal de procesamiento: abre SettingsProcessing channels y copia el ID del canal que va a recibir las ventas. Empieza con
pc_. - Prefijo del subdominio: en DevelopersOverview, la URL de la API de tu cuenta tiene el formato
https://abcd1234.api.checkout.com(.api.sandbox.checkout.comen el sandbox). El prefijo son los 8 caracteres antes de.api.
Guarda la clave con cuidado
La clave secreta da acceso total a tu cuenta Checkout.com. Pégala solo en Vipter. Si se filtra, revócala en Checkout.com, crea otra y reemplázala en Vipter con el botón Cambiar claves.
Paso 2: crear la conexión en Vipter
- En el panel de Vipter abre PagosProveedoresCheckout.com.
- Haz clic en Nueva conexión. Si la tienda aún no tiene ninguna cuenta Checkout.com, el formulario ya aparece abierto.
- Completa los campos:
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Nombre de la cuenta | Un nombre para reconocer la cuenta, como "Checkout.com Europa". Aparece en los flujos de pago. |
| 2 | País de la cuenta | El país donde se abrió la cuenta Checkout.com. No se puede cambiar después. |
| 3 | Clave secreta (Secret key) | La clave secreta que copiaste en el paso 1 (sk_sbox_ o sk_). |
| 4 | ID del canal de procesamiento (Processing channel ID) | El ID del canal de procesamiento, que empieza con pc_. |
| 5 | Prefijo del subdominio de la API | Los 8 caracteres antes de .api en la URL de la API de tu cuenta, solo letras minúsculas y números. |
| 6 | Conexión de prueba | Encendido, solo acepta la clave del sandbox (sk_sbox_). Apágalo para cobrar de verdad con la clave de producción. |
- Haz clic en Guardar y obtener la URL del webhook. Vipter verifica los datos con Checkout.com antes de guardar. Si alguno está mal, no se guarda nada y el error aparece en el formulario.
El modo de prueba viene encendido
El botón Conexión de prueba empieza encendido para que la primera conexión no le cobre a nadie por error. Para vender, crea la conexión con él apagado y la clave de producción.
Si es la primera cuenta de tarjeta de la tienda, Vipter crea solo los flujos de pago de tarjeta de crédito y débito apuntando a ella. La tienda ya puede cobrar después del paso 4.
Paso 3: registrar el webhook en Checkout.com
Por el webhook, Checkout.com le avisa a Vipter lo que pasa después de la compra, como pagos confirmados, reembolsos y contracargos. Cada aviso llega firmado con una clave que defines en el webhook, y Vipter rechaza los avisos hasta tener esa clave.
- Después de guardar, la tarjeta de la conexión muestra la URL del webhook. Copia la dirección.
- En Checkout.com abre DevelopersWebhooks y crea un webhook nuevo.
- Pega la URL que copiaste en el punto 1 y selecciona los eventos de pago.
- Genera o define la Signature key del webhook, copia el valor y guarda el webhook.
- Vuelve a Vipter, pega la clave en la tarjeta de la conexión y haz clic en Guardar secreto.
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Clave de firma del webhook (Signature key) | La Signature key del webhook que creaste en Checkout.com. |
Paso 4: probar la conexión
- En la tarjeta de la conexión, haz clic en Probar. Vipter consulta Checkout.com con los datos guardados.
- Haz una compra de prueba en el checkout de una oferta, con una de las tarjetas de prueba de la documentación de Checkout.com (página Test cards).
Funcionó si
Aparece el mensaje Conexión OK. y la compra de prueba entra en VentasTransacciones como pagada.
Problemas comunes
-
Tu plan permite N conector(es) activo(s). Mejora el plan para agregar más.
El plan llegó al límite de conexiones activas. Desactiva una conexión que ya no uses o cambia de plan en Plan Vipter.
-
Valor inválido
Uno de los tres datos no tiene el formato de Checkout.com: la clave empieza con
sk_, el canal conpc_y el prefijo tiene exactamente 8 letras minúsculas o números, sinhttps://ni puntos. -
Checkout.com rechazó la clave
La clave es de otro entorno: una clave
sk_sbox_solo funciona con el modo de prueba encendido, y una de producción solo con él apagado. Revisa también que el prefijo y el canal sean de la misma cuenta y del mismo entorno que la clave. -
Los pagos confirmados en Checkout.com no cambian de estado en Vipter
El webhook no se registró o la Signature key guardada en Vipter no es la del webhook. Revisa ambos y guarda la clave de nuevo en la tarjeta de la conexión.
Qué hacer después
- Revisa los flujos de pago para decidir qué cuenta cobra cada pago y cuál sirve de respaldo.
- Mira cómo funcionan los pagos para comparar Checkout.com con los otros proveedores.