Payment Button

The Payment Button lets you create a hosted payment page (webcheckout) in Mexico 🇲🇽 with a single API call. You get back a webcheckoutUrl that you share with or redirect your customer to — Kushki handles the entire checkout experience.

No frontend SDK or payment form required.

How it works

Create the webcheckout

Call POST /smartlink/v1/webcheckout with the product details, payment configuration, and the URL to redirect the customer after payment. Returns a 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"]
  }
}

Response:

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

Redirect the customer

Redirect the customer's browser to the webcheckoutUrl. Kushki presents a branded payment page where the customer selects a payment method and completes the transaction.

Receive the result

After payment, Kushki redirects the customer to your redirectURL. Use Analytics or webhooks to confirm the final transaction status.

Request fields

Field	Required	Description
`kind`	✅	Always `"webcheckout"`
`redirectURL`	✅	URL to redirect the customer after payment
`products`	✅	Array of product objects (see below)
`paymentConfig`	✅	Amount and accepted payment methods
`contactDetail`	Optional	Customer's email and name
`transactionType`	Optional	Transaction type for the charge
`additionalInformation`	Optional	Custom key-value metadata

Product fields

Field	Required	Description
`name`	✅	Product name
`description`	✅	Product description
`quantity`	✅	Number of units
`unitPrice`	✅	Unit price in MXN

Payment configuration

Field	Required	Description
`paymentConfig.amount`	✅	Amount object — see currency section below
`paymentConfig.paymentMethod`	✅	Array of accepted payment methods

Payment methods

Value	Description
`credit-card`	Credit or debit card
`transfer`	Bank transfer (SPEI)
`cash`	Cash at partner collection points

Currency

Currency	Code	Notes
Mexican Peso	`MXN`	Two decimal places — amounts use cents (e.g., `500.00`)

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

Authentication

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Create Payment Button

Generate a hosted webcheckout URL. Redirect your customer to complete payment on a Kushki-hosted page.

Got a suggestion on this documentation? Contact us.

How it works#

Request fields#

Product fields#

Payment configuration#

Payment methods#

Currency#

Authentication#

Using the API#

Available Endpoints#