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 --location 'https://api-uat.kushkipagos.com/smartlink/v2/smart-link' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "publicMerchantId": "string",
    "merchantName": "string",
    "paymentConfigType": "fixed",
    "paymentConfig": {
        "paymentType": "unique",
        "amount": {
            "currency": "USD",
            "subtotalIva": 0,
            "subtotalIva0": 10,
            "iva": 0,
            "ice": 0,
            "extraTaxes": {
                "iac": 0,
                "tasaAeroportuaria": 0,
                "agenciaDeViaje": 0
            }
        },
        "paymentMethod": "cash",
        "subscriptionOptions": {
            "amount": {
                "currency": "USD",
                "subtotalIva": 0,
                "subtotalIva0": 10,
                "iva": 0,
                "ice": 0,
                "extraTaxes": {
                    "iac": 0,
                    "tasaAeroportuaria": 0,
                    "agenciaDeViaje": 0
                }
            },
            "periodicity": "daily",
            "planName": "string",
            "startDate": "2019-08-24",
            "terms": "string"
        },
        "mixedOptions": {
            "numberOfFees": 0,
            "periodicity": "daily",
            "subscriptionDay": 0
        }
    },
    "paymentConfig ": {
        "paymentType": "unique",
        "paymentMethod": "cash",
        "currency": "USD",
        "taxEnabled": true,
        "taxPercentage": 0,
        "defaultAmount": 0,
        "minAmount": 1,
        "maxAmount": 1
    },
    "generalConfig": {
        "productName": "string",
        "description": "string",
        "productImage": "string",
        "brandLogo": "string",
        "executionLimit": 0,
        "showTimer": true,
        "enabled": true,
        "termsAndConditions": "string",
        "promotionalText": "string",
        "expirationDate": 0,
        "buyButtonText": "string",
        "hidePayButtonAmount": false,
        "payButtonText": "string"
    },
    "styleAndStructure": {
        "structure": "checkout",
        "coverModel": "left",
        "buttonStyle": "square",
        "primaryColor": "string",
        "secondaryColor": "string"
    },
    "contact": {
        "email": "string",
        "phoneNumber": "string"
    },
    "formConfig": [
        {
            "label": "string",
            "type": "input",
            "split": true,
            "required": true,
            "disabled": true,
            "name": "string",
            "placeholder": "string",
            "value": "string",
            "validateEmail": true
        }
    ],
    "language": "es"
}'

Response Example

201 - application/json

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

Modified at 2026-07-23 17:45:20

Smartlinks

Update a Smartlink