Kushki Developer Portal
  1. SMARTLINKS V2
Kushki Developer Portal
  • Back to home
  • Chile 🇨🇱
  • Bienvenidos
  • ONLINE PAYMENTS
    • CARD
      • 1. Request a card token
      • 2. Make a charge or deferred charge
      • 3. Void a transaction
      • 4. Refund a transaction
      • 5. Request deferred options
      • 6. Authorize payments
      • 7. Capture an authorized payment
      • 8. Bin Info
      • 9. Bin Info V2
      • 10. Validate OTP
      • 11. Voucher
      • 5. Request deferred options
      • 8. Bin Info
      • 10. Validate OTP
      • 3. Void a transaction
      • 4. Refund a transaction
      • 6. Authorize payments
      • 1. Request a card token
      • 7. Capture an authorized payment
      • 11. Voucher
      • 2. Make a charge or deferred charge
      • 9. Bin Info V2
    • CASH IN
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
    • TRANSFER IN
      • 1. Get Bank List
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 4. Get Status
      • 1. Get Bank List
      • 4. Get Status
      • 2. Request a Transfer In token
      • 3. Init Transaction
    • TRANSFER OUT
      • 1. Get Bank List
      • 2. Request a Transfer Out token
      • 3. Init Transaction
      • 4. Get Status
      • 5. Wallet Balance
      • 2. Request a Transfer Out token
      • 1. Get Bank List
      • 5. Wallet Balance
      • 3. Init Transaction
      • 4. Get Status
    • ONE-CLICK & SCHEDULED PAYMENTS
      • 1. Request a recurring charge token
      • 2. Create a recurring charge
      • 3. Update recurring charge card data
      • 4. Make an One-click payment
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 7. Add a temporary charge or discount
      • 8. Authorize payments
      • 9. Capture an authorized payment
      • 10. Get recurring charge Info
      • 3. Update recurring charge card data
      • 7. Add a temporary charge or discount
      • 10. Get recurring charge Info
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 4. Make an One-click payment
      • 9. Capture an authorized payment
      • 8. Authorize payments
      • 2. Create a recurring charge
      • 1. Request a recurring charge token
    • PAYMENT BUTTON
      • 1. Create a payment button
      • 1. Create a payment button
    • SMARTLINKS V2
      • 1. Create a Smartlink
        POST
      • 2. Get a Smartlink
        GET
      • 3. Delete a Smartlink
        DELETE
      • 4. Update a Smartlink
        PATCH
      • 3. Delete a Smartlink
        DELETE
      • 4. Update a Smartlink
        PATCH
      • 1. Create a Smartlink
        POST
      • 2. Get a Smartlink
        GET
    • PAYMENT CREDENTIALS
      • 1. Create a credential
      • 2. Search credentials
      • 3. Advanced search
      • 4. Activate or deactivate
      • 5. Delete credential
      • 6. Update credential
      • 7. Regenerate a credential
      • 6. Update credential
      • 5. Delete credential
      • 4. Activate or deactivate
      • 2. Search credentials
      • 1. Create a credential
      • 3. Advanced search
      • 7. Regenerate a credential
    • COMMISSIONS
      • 1. Get Commission Configuration
      • 1. Get Commission Configuration
    • GATEWAY STATUS
      • 1. Get gateway status
      • 1. Get gateway status
    • ANALYTICS
      • 1. Get transactions list
      • 1. Get transactions list
    • ASYNC CARD RECURRING CHARGES
      • 1. Request a token
      • 2. Init an async card recurring charge
      • 3. Authorize payments
      • 4. Capture an authorized payment
      • 2. Init an async card recurring charge
      • 4. Capture an authorized payment
      • 1. Request a token
      • 3. Authorize payments
    • CARD ASYNC
      • 1. Request a card async token
      • 2. Init Transaction
      • 3. Authorize payments Copy
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 3. Authorize payments Copy
      • 2. Init Transaction
      • 1. Request a card async token
  • CARD PRESENT PAYMENTS (API RAW)
    • Single payment
  1. SMARTLINKS V2

1. Create a Smartlink

POST
/smartlink/v2/smart-link

Request

Header Params

Body Params application/json

Examples

Responses

🟢201
application/json
Body

🟠400
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/smartlink/v2/smart-link' \
--header 'Private-Merchant-Id: {{CL-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "publicMerchantId": "{{CL-Public-Merchant-Id}}",
    "merchantName": "Merchant CL",
    "paymentConfig": {
        "paymentType": "subscription",
        "amount": {
            "currency": "CLP",
            "subtotalIva": 0,
            "subtotalIva0": 0,
            "iva": 0
        },
        "paymentMethod": "subscription",
        "subscriptionOptions": {
            "amount": {
                "currency": "CLP",
                "subtotalIva": 0,
                "subtotalIva0": 15000,
                "iva": 0
            },
            "periodicity": "monthly",
            "planName": "Starter",
            "startDate": "2022-03-12",
            "terms": "Example terms"
        }
    },
    "generalConfig": {
        "productName": "Plan Hogar",
        "description": "<p>Cobertura completa</p>",
        "productImage": "https://kushki-static.s3.amazonaws.com/smartlinks/product-image.png",
        "brandLogo": "https://kushki-static.s3.amazonaws.com/smartlinks/logo.png",
        "executionLimit": 0,
        "showTimer": false,
        "enabled": true,
        "termsAndConditions": ""
    },
    "styleAndStructure": {
        "structure": "checkout"
    },
    "contact": {
        "email": "soporte@soporte.com",
        "phoneNumber": "988238833"
    },
    "formConfig": [
        {
            "label": "Nombres y apellidos",
            "type": "input",
            "split": false,
            "required": true,
            "disabled": false,
            "name": "nombresyapellidos",
            "placeholder": "Nombres y apellidos",
            "value": ""   
        },
        {
            "split": true,
            "name": "documentodeid",
            "disabled": false,
            "label": "Documento de Id.",
            "placeholder": "Documento de Id.",
            "type": "input",
            "required": false
        },
        {
            "split": true,
            "name": "email",
            "disabled": false,
            "label": "E-mail",
            "placeholder": "E-mail",
            "type": "input",
            "required": false
        }
    ]
    
}'
Response Response Example
201 - 201 - paymentType subscription
{
    "smartLinkUrl": "https://uat.kshk.co/merchant-cl/3WHefILD-"
}
Modified at 2026-01-06 19:33:02
Previous
1. Create a payment button
Next
2. Get a Smartlink
Built with