Payment Button

The Payment Button (also known as Webcheckout) is a hosted payment form on Kushki's servers that lets you accept cards, transfers, and cash payments with a single redirect — no frontend payment form to build or maintain.

Keep in mind!

Due to our risk policies, the available payment methods and the integration type may vary once you complete the affiliation. We will tell you how to proceed if this process applies to your merchant.

Payment Button example

Key Features

Hosted and secured by Kushki — no PCI scope on your side.

Accepts card, transfer, and cash payment methods.

Available in Spanish, English, and Portuguese.

Customizable from the Console (colors, logo, subdomain).

Built-in security: OTP and Sift anti-fraud validation.

Conversion timer included by default.

Compatible with Chrome, Safari, Edge, and Firefox.

Supports pre-authorization flows (PRE_AUTH).

How It Works

Create a Webcheckout

Your backend calls POST /smartlink/v1/webcheckout with the order details and payment configuration. Kushki returns a webcheckoutUrl — a unique, hosted payment page.

Redirect the Customer

Redirect the customer to the webcheckoutUrl. Kushki handles the entire payment experience: method selection, card entry, 3DS, OTP, and confirmation.

Receive the Result

After payment, the customer is redirected to your redirectURL. Kushki also sends a Webhook notification with the transaction result and any additionalInformation you included in the request.

Request

Required fields:

Field	Description
`kind`	Always `"webcheckout"`
`redirectURL`	URL where the customer lands after payment
`products`	Array of at least one product (see below)
`paymentConfig`	Amount breakdown and enabled payment methods

Optional fields:

Field	Description
`contactDetail.email`	Pre-fill the customer's email on the payment form
`contactDetail.name`	Pre-fill the customer's name
`transactionType`	Send `"PRE_AUTH"` to use authorization and capture flow
`additionalInformation`	Free-form object — fields appear in the webhook `metadata`

products[]

Each item in the products array requires:

Field	Type	Description
`name`	string	Product name
`description`	string	Product description
`quantity`	number	Units
`unitPrice`	number	Price per unit

paymentConfig

Field	Required	Description
`amount.subtotalIva`	✅	Subtotal subject to VAT
`amount.subtotalIva0`	✅	Subtotal not subject to VAT
`amount.iva`	✅	VAT amount
`amount.currency`	✅	Always `USD` for Ecuador
`paymentMethod`	✅	Array of enabled methods: `cash`, `transfer`, `credit-card`

Full example

{
  "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"]
  }
}

Response

{
  "webcheckoutId": "mpEtCyMJV",
  "webcheckoutUrl": "https://uat-webcheckout.kushkipagos.com/webcheckout/mpEtCyMJV"
}

Field	Description
`webcheckoutId`	Unique identifier for this webcheckout session
`webcheckoutUrl`	Hosted payment page URL — redirect the customer here immediately

Error Codes

Code	Message	Cause
`K004`	ID de comercio o credencial no válido	Invalid or unauthorized `Private-Merchant-Id`
`WCH001`	Cuerpo de la petición inválido	Malformed or missing required fields

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Create a Payment Button

Generates a hosted webcheckout URL to redirect the customer to the payment form.

Got a suggestion on this documentation? Contact us.

Key Features#

How It Works#

Request#

products[]#

paymentConfig#

Full example#

Response#

Error Codes#

Using the API#

Available Endpoints#

Key Features

How It Works

Request

products[]

paymentConfig

Full example

Response

Error Codes

Using the API

Available Endpoints