Payment Button
¡Ten en cuenta!
Ejemplo del Payment Button
Características principales
PRE_AUTH).Cómo funciona
Crea un Webcheckout
Tu backend llama a
POST /smartlink/v1/webcheckout con los detalles del pedido y la configuración de pago. Kushki devuelve un webcheckoutUrl: una página de pago alojada y única.Redirige al cliente
Redirige al cliente al
webcheckoutUrl. Kushki se encarga de toda la experiencia de pago: selección del método, ingreso de la tarjeta, 3DS, OTP y confirmación.Recibe el resultado
Después del pago, el cliente es redirigido a tu
redirectURL. Kushki también envía una notificación por Webhook con el resultado de la transacción y cualquier additionalInformation que hayas incluido en la solicitud.Solicitud
| Campo | Descripción |
|---|---|
kind | Siempre "webcheckout" |
redirectURL | URL a la que llega el cliente después del pago |
products | Array con al menos un producto (ver abajo) |
paymentConfig | Desglose del monto y métodos de pago habilitados |
| Campo | Descripción |
|---|---|
contactDetail.email | Precarga el correo del cliente en el formulario de pago |
contactDetail.name | Precarga el nombre del cliente |
transactionType | Envía "PRE_AUTH" para usar el flujo de autorización y captura |
additionalInformation | Objeto libre: los campos aparecen en el metadata del webhook |
products[]
products requiere:| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre del producto |
description | string | Descripción del producto |
quantity | number | Unidades |
unitPrice | number | Precio por unidad |
paymentConfig
| Campo | Requerido | Descripción |
|---|---|---|
amount.subtotalIva | ✅ | Subtotal sujeto a IVA |
amount.subtotalIva0 | ✅ | Subtotal no sujeto a IVA |
amount.iva | ✅ | Monto del IVA |
amount.currency | ✅ | Siempre USD para Ecuador |
paymentMethod | ✅ | Array de métodos habilitados: cash, transfer, credit-card |
Ejemplo completo
{
"kind": "webcheckout",
"redirectURL": "https://www.tucomercio.com",
"contactDetail": {
"email": "customer@example.com",
"name": "John Doe"
},
"products": [
{
"name": "Trekking Pro",
"description": "Tenis",
"quantity": 1,
"unitPrice": 100.00
}
],
"paymentConfig": {
"amount": {
"subtotalIva": 89.28,
"subtotalIva0": 0,
"iva": 10.71,
"currency": "USD"
},
"paymentMethod": ["credit-card", "transfer", "cash"]
}
}Respuesta
{
"webcheckoutId": "mpEtCyMJV",
"webcheckoutUrl": "https://uat-webcheckout.kushkipagos.com/webcheckout/mpEtCyMJV"
}| Campo | Descripción |
|---|---|
webcheckoutId | Identificador único de esta sesión de webcheckout |
webcheckoutUrl | URL de la página de pago alojada: redirige al cliente ahí de inmediato |
Códigos de error
| Código | Mensaje | Causa |
|---|---|---|
K004 | ID de comercio o credencial no válido | Private-Merchant-Id inválido o no autorizado |
WCH001 | Cuerpo de la petición inválido | Campos requeridos ausentes o mal formados |
Uso de la API
🟢 Producción
🧪 Sandbox (UAT)
https://api.kushkipagos.com/Endpoints disponibles
¿Tienes una sugerencia sobre esta documentación? Escríbenos.
Modified at 2026-09-07 16:50:17