Create a Smartlink

POST

/smartlink/v2/smart-link

Create a smartLink that can later be shared to a customer in order to complete the payment process.

In the form you can include 6 different type of items:

Input: Useful to create tags so customers can include name, email and other important information for the business.

Select: Useful to select from a list of available options.

Date: Shows a calendar if you need the customer to select a specific date.

Area: Useful to enter multiple lines of text.

Checkbox: Useful to let a customer select one or more options from a limited list of choices.

Radio: Allows the customer to choose only one of a limited list of choices.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

CL - Fixed amount smartlinkCL - Open amount smartlink

curl --location 'https://api-uat.kushkipagos.com/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-07-10 20:43:44

Smartlinks V2

Get a Smartlink