Acepta pagos

Acepta pagos con una terminal POS desde tu punto de venta a través de Cloud terminal API. Cloud terminal API te permite enviar solicitudes a una terminal Ultra o Ultra P desde cualquier aplicación compatible para procesar un pago.

Con Cloud Terminal API lleva el control de tu operación desde tu sistema y utiliza una terminal como un periférico (pinpad) para leer la información de la tarjeta para procesar un pago.

Modelo de datos de la solicitud

Estos son todos los parámetros que puedes configurar al momento de realizar una solicitud.

V1:

PropiedadTipoRequeridoDescripción
serial_numberStringNúmero de serie de la terminal.
amountNumberMonto de la transacción.
identifierStringIdentificador único por transacción generado de tu lado.
tipNumber-Monto de la propina.
descriptionString-Envía un texto que aparecerá en la notificación de la terminal.

V2:

PropiedadTipoRequeridoDescripción
serialNumberStringNúmero de serie de la terminal.
amountNumberMonto de la transacción.
identifierStringIdentificador único por transacción generado de tu lado.
tipNumber-Monto de la propina.
descriptionString-Envía un texto que aparecerá en la notificación de la terminal.
uniqueReferenceString-Identificador único por transacción generado de tu lado para evitar duplicados. Requerida versión de la aplicación 5.0.3 o superior para utilizar esta propiedad.
showNotificationString-Si se establece como true, se recibirá una notificación push en la terminal por cada solicitud, de lo contrario, se abrirá automáticamente la aplicación de pagos para procesar el pago.

Operaciones

Descubre todas las operaciones disponibles a través de integraciones por Cloud Terminal API.

Venta

El proceso de venta se inicia cuando un cliente quiere comprar un producto o servicio en tu establecimiento a través de algún medio de pago físico o digital. Durante el proceso, tu sistema punto de venta envía una solicitud de cobro con la configuración necesaria a la aplicación de pagos, la cuál se comunica con la terminal de forma segura para leer, cifrar y enviar la información de la tarjeta de crédito o débito de tu cliente a Kushki para ser procesada. Recibirás la respuesta de la solicitud en la aplicación de pagos. En caso de que la transacción haya sido autorizada de forma exitosa, se descontará el monto autorizado de la cuenta de tu cliente de forma inmediata y posteriormente será liquidado a tu cuenta bancaria de acuerdo al proceso de liquidación. En caso de error, obtendrás más información en la aplicación de pagos y se podrá reintentar nuevamente la solicitud con un método de pago válido.

Envía una solicitud con la configuración de pago desde tu sistema punto de venta hacia el endpoint Collect card payments para realizar una operación de venta.

curl --request POST \
--url https://kushkicollect.billpocket.dev/push-notifications \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-BP-AUTH: bpAuth' \
--data '{
"amount": 37,
"identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
"serial_number": "TERM123"
}'

Propina

Añade un monto adicional para propina durante una operación de venta en la aplicación de pagos durante el proceso de pago. Elige entre un monto predefinido o ingresa un monto personalizado. En caso de no requerir agregar propina, da clic fuera del diálogo para continuar.

Cloud terminal API propina - MX

Pagos diferidos

Incrementa el monto promedio de compra de tus clientes en tu establecimiento ofreciendo la opción de diferir un pago en un número de cuotas establecido. La transacción deberá cumplir con ciertos requisitos para poder ser diferida. Revisa los requisitos con tu gerente de cuenta.

Para diferir un pago, habilita la opción dentro de los ajustes de la aplicación de pagos y selecciona la opción deseada durante el proceso de pago.

Cloud terminal API diferidos

Revisa la referencia de Cloud terminal API para información más detallada.

Respuesta

Si la información enviada es correcta, obtendrás un código de estado HTTP 201 indicando que la solicitud se envió correctamente a la terminal.

Flujo aplicación de pagos

Recibirás una notificación push en la terminal la cuál deberás seleccionar para iniciar el proceso de pago.

Notificación push

Al seleccionar la notificación, se desplegará la aplicación de pagos con la información enviada. Da clic en el botón COBRAR para iniciar la lectura de la tarjeta.

payment app

Sigue los pasos en pantalla para finalizar el proceso.

Comprueba el resultado de la operación mediante la propiedad result recibida a través de un webhook. Si tiene el valor de aprobada, la transacción se procesó con éxito, de lo contrario, hubo un error al procesar la transacción.


Webhooks
Recibe la respuesta de las operaciones realizadas a través de webhooks. Descubre todos los eventos disponibles.
Datos de prueba
Realiza los ajustes necesarios en tu sistema con los datos de prueba.