Crear un Smartlink

https://api-uat.kushkipagos.com

POST

/smartlink/v2/smart-link

Crea un smartLink que luego puedes compartir con un cliente para que complete el proceso de pago.

En el formulario puedes incluir 6 tipos distintos de elementos:

Input: útil para crear etiquetas donde el cliente puede incluir nombre, email y otra información importante para el negocio.

Select: útil para elegir de una lista de opciones disponibles.

Date: muestra un calendario si necesitas que el cliente elija una fecha específica.

Area: útil para ingresar múltiples líneas de texto.

Checkbox: útil para permitir que el cliente seleccione una o más opciones de una lista limitada.

Radio: permite que el cliente elija solo una opción de una lista limitada.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

CL - Fixed amount smartlinkCL - Open amount smartlink

curl --location '/smartlink/v2/smart-link' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "publicMerchantId": "20000000109815430000",
    "merchantName": "mi-comercio-chile",
    "paymentConfigType": "fixed",
    "paymentConfig": {
        "paymentType": "unique",
        "paymentMethod": [
            "credit-card",
            "transfer",
            "cash"
        ],
        "amount": {
            "subtotalIva": 0,
            "subtotalIva0": 10000,
            "iva": 0,
            "currency": "CLP"
        }
    },
    "generalConfig": {
        "productName": "Producto de ejemplo",
        "description": "Descripción del producto",
        "productImage": "https://yoursite.com/product.jpg",
        "brandLogo": "https://yoursite.com/logo.png",
        "executionLimit": 100,
        "showTimer": false,
        "enabled": true,
        "termsAndConditions": "https://yoursite.com/terms"
    },
    "styleAndStructure": {
        "structure": "checkout",
        "buttonStyle": "round",
        "primaryColor": "#1A4CFF"
    },
    "contact": {
        "email": "user@example.com",
        "phoneNumber": "+56912345678"
    },
    "formConfig": [
        {
            "name": "nombres",
            "label": "Nombre completo",
            "placeholder": "Nombre completo",
            "type": "input",
            "required": true,
            "selected": true
        }
    ],
    "language": "es"
}'

Response Example

201 - application/json

{
    "smartLinkUrl": "https://uat.kshk.co/global/4RUvloWDA"
}

Modified at 2026-10-22 14:08:07

Smartlinks V2

Consultar un Smartlink