1. Smartlinks-v2
  • API Docs Colombia 🇨🇴
  • Online Payments
    • Release Notes
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Create payment (tokenless)
      • Void a transaction
      • Refund a transaction
      • Request deferred options
      • Authorize payments
      • Preauthorization (tokenless)
      • Reauthorize payments
      • Capture an authorized payment
      • Verify Account
      • Validate OTP
      • Bin Info
      • BIN info V2
    • One-Click & Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Make an One-click payment
      • Update recurring charge card data
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
    • Transfer in
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
      • Cancel Transaction
    • Transfer out
      • Get Bank List
      • Get Bank List V2
      • Request a Transfer Out token
      • Init Transaction
      • Get Status
      • Balance for Payouts
    • Cash in
      • Request a cash in token
      • Init Transaction
      • Transaction Status
      • Delete a cash in transaction
      • Update a cash in transaction
    • Cash-out
      • Request a cash out token
      • Init Transaction
      • Transaction Status
      • Update a cash out transaction
      • Delete a cash out transaction
    • Smartlinks-v2
      • Create a Smartlink
        POST
      • Get a Smartlink
        GET
      • Update a Smartlink
        PATCH
      • Delete a smartlink
        DELETE
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Gateway-status
      • Get gateway status
      • Get platform status
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Advanced search
      • Delete credential
      • Regenerate a credential
      • Activate or deactivate
      • Update credential
    • Payment Button
      • Create a payment button
    • Settlement
      • Query settlement
    • Subscription Transactions
      • Get subscription transactions
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
        • Search
          • Transaction Search
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • API Raw Card Present Payments
    • Release Notes
    • Error Catalog
    • The Amount Object
    • Key Exchange Process
    • Test data
    • One-time Payments
      • Single payment
    • Two-step Payments
      • Authorization and capture
    • Card Information
      • Get BIN Info
      • BIN info V2
      • Request deferred options
    • Voids & Refunds
      • Void & Reverse
      • Refund a transaction
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Introduction
      • Good Practices
      • Webhooks-Card Payments
      • Webhooks-Refunds
      • Check your webhooks
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • SubscriptionTransactionsResponse
    • Card
    • Channel
    • Amount-cash-in
    • ChargebackListResponse
    • SettlementDateRangeRequest
    • TransactionResponse
    • PrintJobRequest
    • card
    • amount
    • one-and-two-step-payment-3
    • SubscriptionTransaction
    • networkToken
    • ChargebackItem
    • SettlementRecord
    • RawResponse
    • CommandText
    • ErrorResponse
    • currency
    • webhooksItem
    • ErrorResponse400
    • SettlementResponse
    • CardData
    • CommandColumns
    • extra_taxes
    • Amount
    • ErrorResponse401
    • LinkFailure
    • ColumnItem
    • pos_details
    • extraTaxes
    • ErrorResponse403
    • CommandDivider
    • card_details
    • enc_tlv
    • TransactionEvent
    • Deferred
    • Country
    • payment_method
    • ErrorResponse500
    • CommandFeed
    • deferred
    • TransactionStatus
    • CommandSpace
    • contact_details
    • ReadingType
    • ContactDetails
    • CommandCut
    • sub_merchant
    • FailureReason
    • documentType
    • Subscription
    • CommandImage
    • metadata
    • EventTerminal
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • EventExtraTaxes
    • PrintJobAccepted
    • SubscriptionUpdate
    • PrinterError
    • EventMetadata
    • threeDomainSecure
    • SubscriptionAdjustmentRequest
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • product
    • webhooks
    • AmountCore
    • headers
    • ExtraTaxes
    • PrintWebhookPayload
    • Metadata
    • webhooksChargeback
    • citMit
    • AmountWithTip
    • network
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • binInfo
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • messageFields
    • TransactionEvent_2
    • UnexpectedErrorResponse
    • FailureReason_2
    • transactionType
    • ExternalReferenceId
    • EventTerminal_2
    • ExternalSubscriptionId
    • EventOperation_2
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • SettlementTicketRequest
    • Amount-old
    • currency
    • extraTaxes2
    • currency
    • ErrorResponse
    • TransactionEvent_23
    • TransactionStatus4
    • ReadingType5
    • FailureReason_26
    • EventTerminal_27
    • EventOperation_28
    • EventAmount_29
    • EventMetadata_210
    • EventExtraTaxes_211
    • PrintWebhookPayload12
    • TransactionEvent13
    • FailureReason14
    • EventTerminal15
    • EventOperation16
    • EventAmount17
    • EventMetadata18
    • EventExtraTaxes19
BienvenidaPerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴
Chile 🇨🇱
BienvenidaPerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴
Chile 🇨🇱
  1. Smartlinks-v2

Get a Smartlink

UAT Testing Env
https://api-uat.kushkipagos.com
UAT Testing Env
https://api-uat.kushkipagos.com
GET
/smartlink/v2/smart-link/{smartlinkId}
Get the Smartlink information that can be used to render the form in a website hosted by Kushki.
To keep in mind
Got a suggestion on this documentation? Contact Us.

Request

Path Params

Header Params

Responses

🟢200OK
application/json
Body

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/smartlink/v2/smart-link/' \
--header 'Private-Merchant-Id;'
Response Response Example
200 - Example 1
{
    "merchantName": "string",
    "executionCount": 0,
    "version": "string",
    "created": 0,
    "publicMerchantId": "string",
    "id": "string",
    "merchantId": "string",
    "subscriptionTotalAmount": 0,
    "totalAmount": 0,
    "paymentConfig": {
        "paymentType": "unique",
        "amount": {
            "currency": "COP",
            "extra_taxes": {
                "airport_tax": 0,
                "iac": 0,
                "ice": 0,
                "travel_agency": 0
            },
            "iva": 0,
            "subtotal_iva": 0,
            "subtotal_iva0": 100,
            "tip": 0
        },
        "paymentMethod": "cash",
        "subscriptionOptions": {
            "amount": {
                "currency": "PEN",
                "subtotalIva": 0,
                "subtotalIva0": 0,
                "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
        },
        "currency": "COP",
        "taxEnabled": true,
        "taxPercentage": 1,
        "defaultAmount": 0,
        "minAmount": 0,
        "maxAmount": 0
    },
    "generalConfig": {
        "productName": "string",
        "description": "string",
        "productImage": "string",
        "brandLogo": "string",
        "executionLimit": 0,
        "showTimer": true,
        "enabled": true,
        "termsAndConditions": "string",
        "promotionalText": "string",
        "expirationDate": 0,
        "buyButtonText": "string",
        "hidePayButtonAmount": true,
        "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"
        }
    ],
    "paymentConfigType": "open",
    "language": "es",
    "source": "api"
}
Modified at 2026-08-25 14:01:22
Previous
Create a Smartlink
Next
Update a Smartlink
Built with