Payment Button

El Payment Button te permite crear una página de pago alojada (webcheckout) en México 🇲🇽 con una sola llamada a la API. Recibes un webcheckoutUrl que compartes con tu cliente o al que lo rediriges: Kushki se encarga de toda la experiencia de checkout.

No necesitas SDK de frontend ni formulario de pago.

Cómo funciona

Crea el webcheckout

Llama a POST /smartlink/v1/webcheckout con los detalles del producto, la configuración del pago y la URL a la que se redirige al cliente después de pagar. Devuelve un webcheckoutUrl.

{
  "kind": "webcheckout",
  "contactDetail": {
    "email": "user@example.com",
    "name": "Juan García"
  },
  "redirectURL": "https://www.micomercio.com.mx/gracias",
  "products": [
    {
      "name": "Producto Premium",
      "description": "Producto de ejemplo",
      "quantity": 1,
      "unitPrice": 500
    }
  ],
  "paymentConfig": {
    "amount": {
      "subtotalIva0": 500,
      "subtotalIva": 0,
      "iva": 0,
      "currency": "MXN"
    },
    "paymentMethod": ["credit-card", "transfer", "cash"]
  }
}

Respuesta:

{
  "webcheckoutId": "T3iDy0G4E",
  "webcheckoutUrl": "https://webcheckout.kushkipagos.com/webcheckout/T3iDy0G4E"
}

Redirige al cliente

Redirige el navegador del cliente al webcheckoutUrl. Kushki muestra una página de pago con tu marca donde el cliente elige un método de pago y finaliza la transacción.

Recibe el resultado

Después del pago, Kushki redirige al cliente a tu redirectURL. Usa Analytics o webhooks para confirmar el estado final de la transacción.

Campos del request

Campo	Obligatorio	Descripción
`kind`	✅	Siempre `"webcheckout"`
`redirectURL`	✅	URL a la que se redirige al cliente después del pago
`products`	✅	Array de objetos de producto (ve el detalle abajo)
`paymentConfig`	✅	Monto y métodos de pago aceptados
`contactDetail`	Opcional	Correo y nombre del cliente
`transactionType`	Opcional	Tipo de transacción del cargo
`additionalInformation`	Opcional	Metadata personalizada de tipo llave-valor

Campos del producto

Campo	Obligatorio	Descripción
`name`	✅	Nombre del producto
`description`	✅	Descripción del producto
`quantity`	✅	Cantidad de unidades
`unitPrice`	✅	Precio unitario en MXN

Configuración del pago

Campo	Obligatorio	Descripción
`paymentConfig.amount`	✅	Objeto de monto — ve la sección de moneda más abajo
`paymentConfig.paymentMethod`	✅	Array de métodos de pago aceptados

Métodos de pago

Valor	Descripción
`credit-card`	Tarjeta de crédito o débito
`transfer`	Transferencia bancaria (SPEI)
`cash`	Efectivo en puntos de recaudo aliados

Moneda

Moneda	Código	Notas
Peso mexicano	`MXN`	Dos decimales — los montos usan centavos (por ejemplo, `500.00`)

"amount": {
  "subtotalIva0": 500,
  "subtotalIva": 0,
  "iva": 0,
  "currency": "MXN"
}

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Crear un Payment Button

Genera una URL de webcheckout alojada. Redirige a tu cliente para que complete el pago en una página alojada por Kushki.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Cómo funciona#

Campos del request#

Campos del producto#

Configuración del pago#

Métodos de pago#

Moneda#

Autenticación#

Uso de la API#

Endpoints disponibles#