1. Smartlinks V2
  • API Docs Peru 🇵🇪
  • Online Payments
    • Release Notes
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Preauthorization (tokenless)
      • Create payment (tokenless)
      • Void a transaction
      • Refund a transaction
      • Verify Account
      • Request deferred options
      • Authorize payments
      • Reauthorize payments
      • Capture an authorized payment
      • Validate OTP
      • Bin Info V2
      • Bin Info
    • One-Click & Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Update recurring charge card data
      • Make an One-click payment
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • Card Out
      • Get Card Payout Token
      • Get Subscription Token
      • Push funds
      • Push Funds in subscriptions
      • Get transaction status
      • Delete Subscription
    • Transfer In
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • 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
    • Smartlinks V2
      • Create a Smartlink
        POST
      • Update a Smartlink
        PATCH
      • Get a Smartlink
        GET
      • Delete a smartlink
        DELETE
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
    • Gateway Status
      • Get gateway status
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Advanced search
      • Activate or deactivate
      • Delete credential
      • Update credential
      • Regenerate a credential
    • Payment Button
      • Create a payment button
    • Platform Status
      • Get platform status
    • Subscription Transactions
      • Get subscription transactions
    • Settlement
      • Query settlement
  • Card Present Payments (API Raw)
    • Release notes
    • Key Exchange Process
    • Test data
    • Kushki Error Catalog for POS transactions
    • The Amount Object
    • One-time Payments
      • Single payment
    • Two-step Payments
      • Authorization and capture
    • Voids & Refunds
      • Refund a transaction
      • Void & Reverse
    • Card information
      • Get BIN Info
      • Bin Info V2
      • Request deferred options
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Introduction
      • Good practices
      • Refunds
      • Card Payments
      • Check your webhooks
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment Cloud
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Refund
          • Abort
          • Void
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
        • Search
          • Transaction Search
      • Print Cloud
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment Local
        • 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 Local
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • Shared
      • ErrorResponse
      • BadRequestResponse
      • InvalidBinResponse
      • payment_method
      • payment_submethod
      • messageFields
      • Channel
    • Amount & Taxes
      • Amount-cash-in
      • GetConfigurationRequest
    • Identity & Contact
      • Shipping Address
    • Card & Payments
      • ChargesVoidCardResponse
      • Promotions
      • Submerchant
    • Subscriptions
      • SubscriptionUpdate
      • SubscriptionAdjustmentRequest
      • SubscriptionTransactionsResponse
    • Webhooks
    • Analytics
      • AnalyticsTransactionItem
      • AnalyticsListResponse
    • Settlement
      • SettlementDateRangeRequest
      • SettlementTicketRequest
      • SettlementResponse
    • Chargebacks
      • ChargebackListResponse
      • ChargebackSearchRequest
    • Cash
      • CashChargeInitRequest
      • CashStatusResponse
    • Transfer
      • TransferTokenRequest
      • TransferInitRequest
      • TransferStatusResponse
    • Payouts
      • PayoutsWebhooksItem
    • Smart Link
      • SmartLinkAmount
    • Terminal
      • TerminalContactDetails
      • TerminalCardDetails
      • TerminalPosDetails
      • TransactionSearchRequest
      • TerminalCardData
    • RequestBodies
      • one-and-two-step-payment
    • SettlementDateRangeRequest
    • SubscriptionTransactionsResponse
    • card-old
    • AmountWithTaxes-old
    • Card
    • TransactionResponse
    • PrintJobRequest
    • amount
    • one-and-two-step-payment
    • Shipping Address
    • transactionType
    • ChargebackItem-old
    • SubscriptionTransaction
    • amount
    • AmountCore-old
    • CommandText-old
    • networkToken
    • Language
    • extra_taxes
    • CommandText
    • RawResponse
    • currency
    • ErrorResponse400-old
    • webhooksItem
    • ErrorResponse
    • SettlementResponse
    • extra_taxes-old
    • ExtraTaxes-old
    • CommandColumns-old
    • currency
    • card
    • CommandColumns
    • CardData
    • orderDetails-old
    • Country
    • ErrorResponse401-old
    • SettlementRecord
    • pos_details-old
    • ColumnItem-old
    • Amount
    • LinkFailure
    • card_details
    • ColumnItem
    • documentType
    • extraTaxes-old
    • ErrorResponse403-old
    • card_details-old
    • TransactionResponse-old
    • CommandDivider-old
    • extraTaxes
    • enc_tlv
    • CommandDivider
    • TransactionEvent
    • payment_method
    • ErrorResponse500-old
    • threeDomainSecure
    • enc_tlv
    • RawResponse-old
    • CommandFeed-old
    • Deferred
    • deferred
    • CommandFeed
    • TransactionStatus
    • binInfo
    • contact_details-old
    • CardData-old
    • CommandSpace-old
    • pos_details
    • CommandSpace
    • ReadingType
    • Billing-Address-old
    • Deferred-old
    • deferred-old
    • sub_merchant
    • AmountWithTip-old
    • CommandCut-old
    • contact_details
    • sub_merchant
    • CommandCut
    • FailureReason
    • headers
    • Amount-old
    • metadata
    • LinkFailure-old
    • CommandImage-old
    • metadata
    • CommandImage
    • EventTerminal
    • ContactDetails-old
    • SubscriptionUpdate
    • TransactionSearchRequest-old
    • CommandQR-old
    • orderDetails
    • Subscription
    • CommandQR
    • EventOperation
    • payment_submethod
    • citMit
    • SubscriptionAdjustmentRequest
    • CommandBarcode-old
    • Shipping Address
    • CommandBarcode
    • EventAmount
    • messageFields
    • PrinterError-old
    • Billing Address
    • EventExtraTaxes
    • PrintJobAccepted
    • webhooksChargeback
    • Language
    • PrintJobStatus-old
    • PrinterError
    • EventMetadata
    • webhooks
    • networkToken-old
    • PrintWebhookPayload-old
    • threeDomainSecure
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • webhooks
    • AmountCore
    • product-old
    • headers
    • PrintWebhookPayload
    • ExtraTaxes
    • Metadata
    • webhooksChargeback
    • UnexpectedErrorResponse-old
    • citMit
    • AmountWithTip
    • network
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • Card-old-old
    • binInfo
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • messageFields
    • TransactionEvent_2
    • Promotions-old
    • UnexpectedErrorResponse
    • FailureReason_2
    • transactionType
    • EventTerminal_2
    • EventOperation_2
    • InvalidBinResponse-old
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • currency
    • Amount-CL-old
    • SettlementTicketRequest
    • metadata
    • payment_method
    • currency
    • currency
    • Submerchant
    • Shipping Address
    • GetConfigurationRequest-old
    • BadRequestResponse
    • ContactDetails
    • product
    • TransactionEvent_21
    • TransactionStatus2
    • ReadingType3
    • FailureReason_24
    • EventTerminal_25
    • EventOperation_26
    • EventAmount_27
    • EventMetadata_28
    • EventExtraTaxes_29
    • PrintWebhookPayload10
    • TransactionEvent11
    • FailureReason12
    • EventTerminal13
    • EventOperation14
    • EventAmount15
    • EventMetadata16
    • EventExtraTaxes17
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.

Request

Path Params

Header Params

Responses

🟢200OK
application/json
Bodyapplication/json

🟠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 - Smartlink found
{
    "paymentConfig": {
        "mixedOptions": {
            "numberOfFees": 13,
            "periodicity": "weekly",
            "subscriptionDay": 28
        },
        "paymentMethod": [
            "cash",
            "credit-card",
            "transfer"
        ],
        "amount": {
            "currency": "PEN",
            "subtotalIva0": 0,
            "iva": 211.09,
            "subtotalIva": 1111
        },
        "subscriptionOptions": {
            "periodicity": "weekly",
            "planName": "Subscription-SmartLink",
            "amount": {
                "currency": "PEN",
                "subtotalIva0": 0,
                "iva": 422.18,
                "subtotalIva": 2222
            },
            "terms": "T&C suscripcion",
            "startDate": "2020-03-15"
        },
        "paymentType": "mixed"
    },
    "executionCount": 0,
    "version": "V2",
    "formConfig": [
        {
            "split": true,
            "icon": "bold",
            "name": "nombresyapellidos",
            "disabled": false,
            "label": "Nombres y apellidos",
            "placeholder": "Nombres y apellidos",
            "type": "input",
            "required": false,
            "selected": false
        },
        {
            "split": true,
            "icon": "bold",
            "name": "email",
            "disabled": false,
            "label": "E-mail",
            "placeholder": "E-mail",
            "type": "input",
            "required": false,
            "selected": false
        },
        {
            "split": true,
            "icon": "server",
            "name": "listadeseleccion",
            "options": [
                "Opcion 1",
                "Opcion 2",
                "Opcion 3"
            ],
            "index": 3,
            "disabled": false,
            "label": "Lista de selección",
            "type": "select",
            "required": false,
            "selected": false
        },
        {
            "split": true,
            "icon": "check-circle",
            "name": "seleccionmultiple",
            "options": [
                "Opcion 1",
                "Opcion 2"
            ],
            "index": 3,
            "disabled": false,
            "label": "Selección múltiple",
            "type": "checkbox",
            "required": false,
            "selected": false
        },
        {
            "split": true,
            "icon": "calendar",
            "name": "fecha",
            "index": 4,
            "disabled": false,
            "label": "Fecha",
            "type": "date",
            "required": false,
            "selected": false
        },
        {
            "split": true,
            "icon": "bold",
            "name": "areadetexto",
            "index": 4,
            "disabled": false,
            "label": "Área de texto",
            "placeholder": "Área de texto",
            "type": "area",
            "required": false,
            "selected": false
        }
    ],
    "generalConfig": {
        "productImage": "https://kushki-static.s3.amazonaws.com/smartlinks/product-image.png",
        "showTimer": true,
        "buyButtonText": "pago",
        "description": "<p>Descipción</p>",
        "executionCount": 0,
        "executionLimit": 999,
        "promotionalText": "promocional",
        "brandLogo": "https://kushki-static.s3.amazonaws.com/smartlinks/logo.png",
        "enabled": true,
        "productName": "nombre producto",
        "expirationDate": 1585717199999,
        "termsAndConditions": "tyc smartlink"
    },
    "created": 1585715919666,
    "publicMerchantId": "20000000100338110000",
    "merchantName": "CLINICA OFTALMOLOGICA",
    "styleAndStructure": {
        "primaryColor": "#00E6B2",
        "coverModel": "left",
        "structure": "cover",
        "buttonStyle": "square",
        "secondaryColor": "#023366"
    },
    "id": "4RUvloWDA",
    "merchantId": "20000000100338110000",
    "subscriptionTotalAmount": 2644.18,
    "totalAmount": 1322.09,
    "paymentConfigType": "fixed",
    "source": "console"
}
Modified at 2026-08-25 14:41:44
Previous
Update a Smartlink
Next
Delete a smartlink
Built with