1. ONE-CLICK & SCHEDULED PAYMENTS
Español
  • Español
  • English
  • Bienvenida
    • Home Page
  • Perú 🇵🇪
    • Kushki Developer Portal 🚀
    • Perú 🇵🇪
    • Raíz
      • Libraries & SDKs (Online Payments)
        • Release notes
        • Mobile
          • Kushki Android
          • Kushki iOS 
          • Kushki iOS ARM Setup
        • Web
          • Kushki.js 🌐
          • kushki.js-hosted-fields
            • kushki.js Hosted Fields
            • Guía de migración a Kushki.js 2.0
            • Antifraud
              • Interfaces
                • SecureInitRequest
                • SecureInitResponse
                • SiftScienceObject
              • Methods
                • requestInitAntiFraud
                • requestSecureInit
                • requestValidate3DS
            • Card
              • CarApplePay interface
                • ICardApplePay Interface
              • Card-Interface
                • ICard Interface
                • ICardSubscriptions Interface
              • Errors
                • Error list
              • Interfaces
                • Amount
                • ApplePayGetTokenOptions Interface
                • ApplePayOptions Interface
                • ApplePayPaymentContact
                • AppleTokenResponse
                • BrandByMerchantResponse Interface
                • CardFieldValues
                • CardInfo
                • CardOptions
                • CardTokenResponse
                • DeferredByBinOptionsResponse
                • DeferredInputValues
                • DeferredValuesResponse
                • DeviceTokenRequest
                • Field
                • FieldInstance
                • Fields
                • FieldValidity
                • FormValidity
                • MasterCardBrandingRequest
                • SecureDeviceTokenOptions
                • Styles
                • TokenResponse
                • VisaBrandingRequest
              • Methods
                • initApplePayButton
                • initCardToken
                • initSecureDeviceToken
                • requestBrandsByMerchant method
                • requestDeviceToken method
                • requestInitCardBrandingAnimation
              • Types
                • CssProperties
                • Currency
                • FieldTypeEnum
            • Card Payouts
              • Card Payouts Interface
                • ICardPayouts
              • Enumerations
                • Enumeration `InputModelEnum`
              • Errors
                • Errors
              • Interfaces
                • CardPayoutOptions
                • CardPayoutSubscriptionTokenResponse
                • CardPayoutUniqueTokenResponse
                • Field
                • Fields
                • FieldValidity
                • Interface FormValidity
                • Interface `Styles`
              • Methods
                • initCardPayoutToken
              • Type Aliases
                • CardPayoutTokenResponse
                • InputTypeEnum
              • Types
                • CssProperties
            • Kushki
              • Methods
                • init function
                • requestBankList function
                • requestCommissionConfiguration function
              • Classes
                • KushkiError
              • Interfaces
                • CommissionConfigurationRequest
                • IKushki
                • KushkiOptions
    • Schemas
      • API Raw Card Present
        • metadata
        • extra_taxes
        • card
        • sub_merchant
        • pos_details
        • enc_tlv
        • deferred
        • contact_details
        • card_details
        • amount
      • Chargebacks
      • Commissions
      • Gateway Status
      • ChargebackListResponse
      • StatusComponent
      • currency
      • one-and-two-step-payment
      • webhooksChargeback
      • ChargebackItem
      • webhooks
      • networkToken
      • webhooksItem
      • transactionType
      • ErrorResponse400
      • threeDomainSecure
      • ErrorResponse401
      • product
      • ErrorResponse403
      • payment_submethod
      • ErrorResponse500
      • payment_method
      • paymentMethod
      • orderDetails
      • Shipping Address
      • headers
      • extraTaxes
      • documentType
      • currency
      • currency-cash-in
      • currency-CL
      • binInfo
      • UnexpectedErrorResponse
      • citMit
      • SubscriptionUpdate
      • messageFields
      • network
      • SubscriptionAdjustmentRequest
      • Subscription
      • Submerchant
      • Shipping-Address
      • Promotions
      • Metadata
      • Language
      • InvalidBinResponse
      • GetConfigurationRequest
      • ErrorResponse
      • Deferred
      • Country
      • ContactDetails
      • ChargesVoidCardResponse
      • Channel
      • Card
      • Billing-Address
      • BadRequestResponse
      • Amount
      • Amount-cash-in
      • Amount-CL
  • México 🇲🇽
    • Bienvenidos
    • ONLINE PAYMENTS
      • CARD
        • 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. Reauthorize payments
        • 8. Capture an authorized payment
        • 9. Bin Info
        • 10. Bin Info V2
        • 11. Validate OTP
        • 12. Verify Account
        • 12. Verify Account
        • 6. Authorize payments
        • 10. Bin Info V2
        • 8. Capture an authorized payment
        • 3. Void a transaction
        • 4. Refund a transaction
        • 7. Reauthorize payments
        • 1. Request a card token
        • 9. Bin Info
        • 5. Request deferred options
        • 2. Make a charge or deferred charge
        • 11. Validate OTP
      • 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. Request a Transfer In token
        • 2. Init Transaction
        • 4. Get Status Copy
        • 1. Request a Transfer In token
        • 4. Get Status Copy
        • 2. Init Transaction
      • TRANSFER OUT
        • 1. Get Bank List
        • 2. Request a Transfer Out token
        • 3. Init Transaction
        • 4. Get Status
        • 5. Wallet Balance
        • 5. Wallet Balance
        • 1. Get Bank List
        • 4. Get Status
        • 2. Request a Transfer Out token
        • 3. Init Transaction
      • ONE-CLICK & SCHEDULED PAYMENTS
        • 1. Request a recurring charge token
          POST
        • 2. Create a recurring charge
          POST
        • 3. Update recurring charge card data
          PUT
        • 4. Make an One-click payment
          POST
        • 5. Cancel a recurring charge
          DELETE
        • 6. Update a recurring charge
          PATCH
        • 7. Add a temporary charge or discount
          PUT
        • 8. Authorize payments Copy
          POST
        • 9. Capture an authorized payment Copy
          POST
        • 10. Get recurring charge Info
          GET
        • 1. Request a recurring charge token
          POST
        • 8. Authorize payments Copy
          POST
        • 3. Update recurring charge card data
          PUT
        • 6. Update a recurring charge
          PATCH
        • 10. Get recurring charge Info
          GET
        • 2. Create a recurring charge
          POST
        • 5. Cancel a recurring charge
          DELETE
        • 9. Capture an authorized payment Copy
          POST
        • 4. Make an One-click payment
          POST
        • 7. Add a temporary charge or discount
          PUT
      • PAYMENT BUTTON
        • 1. Create a payment button
        • 1. Create a payment button
      • SMARTLINKS V2
        • 1. Create a Smartlink
        • 2. Get a Smartlink
        • 3. Delete a Smartlink
        • 4. Update a Smartlink
        • 1. Create a Smartlink
        • 4. Update a Smartlink
        • 2. Get a Smartlink
        • 3. Delete a Smartlink
      • 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
        • 3. Advanced search
        • 6. Update credential
        • 5. Delete credential
        • 2. Search credentials
        • 4. Activate or deactivate
        • 7. Regenerate a credential
        • 1. Create 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
    • CARD PRESENT PAYMENTS (BILLPOCKET)
      • Get token
      • States
      • Validate token
      • Municipalities
      • Collect payments
      • Tax companies
      • Capture an authorized payment
      • Commercial activities
      • Refund
      • Create checkout
      • Get status
      • Get checkout details
      • Collect card payments
      • Print Ticket
      • Collect card payments v2
      • Cancel Push Notification
      • Get transaction status
      • Add or update CLABE account
      • Configure payment link
      • Get payment link configuration
      • Create payment link
      • Update payment link
      • List payment links
      • Delete payment link
      • Add CLABE account
      • Get token
      • Get transaction list
      • Get transaction list v2
      • Get transaction list v3
      • Get transaction list v4
      • Create user
    • CARD PRESENT PAYMENTS (API RAW) Copy Copy
      • error-catalog
      • Test data
      • One-time payments
        • Single payment
      • Two-step-payments
        • Authorization and capture
      • Voids & Refunds
        • Void & Reverse
        • Refund a transaction
      • Card information
        • Balance inquiries
        • Get BIN Info
        • BIN info V2
        • Request deferred options
      • Query Transactions
        • Transaction Search
  • Ecuador 🇪🇨
    • Bienvenidos
    • ONLINE PAYMENTS
      • Card
        • Overview
        • Request a card token
        • Make a charge or deferred charge
        • Void a transaction
        • Request deferred options
        • Validate OTP
        • Refund a transaction
        • Bin Info
        • Bin Info V2
      • One Click Charges
        • Overview
        • Request a recurring charge token
        • Create a recurring charge
        • Make an One-click payment
        • Cancel a recurring charge
        • Add a temporary charge or discount
        • Get recurring charge Info
        • Update a recurring charge
        • Update recurring charge card data
      • Transfer in
        • Overview
        • Get Bank List
        • Request a Transfer In token
        • Init Transaction
        • Get Status
      • Cash in
        • Overview
        • Request a cash in token
        • Init Transaction
        • Transaction Status
        • Update a cash in transaction
        • Delete a cash in transaction
      • Chargebacks
        • Overview
        • Query chargebacks
        • Request chargeback export
      • Smartlinks
        • Overview
        • Create a Smartlink
        • Update a Smartlink
        • Get a Smartlink
        • Delete a smartlink
        • Get a Smartlink
        • Delete a Smartlink
        • Update a Smartlink
        • Create a Smartlink
      • Payment Button
        • Overview
        • Create a payment button
      • Payment Credentials
        • Overview
        • Regenerate a credential
        • Activate or deactivate
        • Update credential
        • Search credentials
        • Delete credential
        • Create a credential
        • Advanced search
      • Gateway Status
        • Overview
        • Get gateway status
      • Analytics
        • Overview
        • Get transactions list v2
        • Get transactions list v1
      • Commissions
        • Commissions
        • Get Commission Configuration
  • Colombia 🇨🇴
    • ANALYTICS
      • Get transactions list v1
      • Get transactions list v2
    • CARD-OUTS
      • Request a cash out token
      • Init Transaction
      • Update a cash out transaction
      • Delete a cash out transaction
      • Transaction Status
    • CARD
      • Bin Info
      • Bin Info V2
      • Request deferred options
      • Request a card token
      • Make a charge or deferred charge
      • Create payment (tokenless)
      • Authorize payments
      • Preauthorization (tokenless)
      • Capture an authorized payment
      • Reauthorize payments
      • Refund a transaction
      • Void a transaction
      • Verify Account
      • Validate OTP
    • 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
      • Void a transaction
      • Balance for Payouts
    • CASH-IN
      • Request a cash in token
      • Init Transaction
      • Update a cash in transaction
      • Delete a cash in transaction
      • Transaction Status
    • CASH-OUT
      • Request a cash out token
      • Init Transaction
      • Update a cash out transaction
      • Delete a cash out transaction
      • Transaction Status
    • COMMISSIONS
      • Get Commission Configuration
    • GATEWAY-STATUS
      • Get gateway status
      • Get platform status
    • ONE-CLICK & SCHEDULED PAYMENTS
      • Request a recurring charge token
      • Update recurring charge card data
      • Update a recurring charge
      • Add a temporary charge or discount
      • Get recurring charge Info
      • Create a recurring charge
      • Make an One-click payment
      • Cancel a recurring charge
      • Authorize payments
      • Capture an authorized payment
    • PAYMENT-BUTTON
      • Create a payment button
    • PAYMENT-CREDENTIALS
      • Advanced search
      • Delete credential
      • Regenerate a credential
      • Search credentials
      • Activate or deactivate
      • Update credential
      • Create a credential
    • SMARTLINKS-V2
      • Create a Smartlink
      • Get a Smartlink
      • Update a Smartlink
      • Delete a smartlink
    • TRANSFER-IN
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • TRANSFER-OUT
      • Balance for Payouts
      • Get Bank List
      • Get Bank List V2
      • Request a Transfer Out token
      • Init Transaction
      • Get Status
      • Void a transaction
  • Chile 🇨🇱
    • Bienvenidos
    • CARD PRESENT PAYMENTS (API RAW) Copy
      • One-time payments
      • Two-step-payments
      • Voids & Refunds
      • Card information
      • Query Transactions
    • Online Payments
      • Card Async
        • Request a card async token
        • Authorize payments
        • Get Status
        • Capture an authorized payment
        • Init Transaction
      • Async Card Recurring Charges
        • Request an async card recurring charge token
        • Init an async card recurring charge
        • Capture an authorized payment
        • Authorize payments
        • Capture an authorized payment
        • Authorize payments
      • Card
        • Bin Info
        • Bin Info V2
        • Request deferred options
        • Request a card token
        • Make a charge or deferred charge
        • Create payment (tokenless)
        • Authorize payments
        • Capture an authorized payment
        • Reauthorize payments
        • Void a transaction
        • Refund a transaction
        • Voucher
        • Validate OTP
        • Verify Account
      • Chargebacks
        • Query chargebacks
        • Request chargeback export
      • Transfer In
      • Transfer Out
      • Cash In
      • Smartlinks V2
      • Analytics
        • Get transactions list v1
        • Get transactions list v2
      • Gateway Status
        • Get gateway status
      • Commissions
      • Payment Credentials
      • Payment Button
      • Platform Status
      • Subscription Transactions
      • Preauthorization (tokenless)
  1. ONE-CLICK & SCHEDULED PAYMENTS

8. Authorize payments Copy

POST
/subscriptions/v1/card/{{subscriptionId}}/authorize

Request

Header Params

Body Params application/json

Examples

Responses

🟢201
application/json
Body

🟠400
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api-uat.kushkipagos.com/subscriptions/v1/card//authorize' \
--header 'Private-Merchant-Id: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": {
    "ice": 0,
    "iva": 0,
    "subtotalIva": 0,
    "subtotalIva0": 1000,
    "currency": "MXN"
  },
  "name": "John",
  "lastName": "Doe",
  "email": "user@example.com",
   "orderDetails": {
    "siteDomain": "tuebook.com",
    "shippingDetails": {
      "name": "John Doe",
      "phone": "+523912345678",
      "address": "Eloy Alfaro 139 y Catalina Aldaz",
      "city": "Querétaro",
      "region": "Centro",
      "country": "México",
      "zipCode": "170402"
    },
    "billingDetails": {
      "name": "John Doe",
      "phone": "+523912345678",
      "address": "Eloy Alfaro 139 y Catalina Aldaz",
      "city": "Querétaro",
      "region": "Centro",
      "country": "México",
      "zipCode": "170402"
    }
  },
  "fullResponse": "v2"
}'
Response Response Example
201 - 201 - Authorize deferred
{
    "ticketNumber": "488892209101141831",
    "details": {
        "approvedTransactionAmount": 1000,
        "requestAmount": 1000,
        "responseCode": "000",
        "approvalCode": "000000",
        "syncMode": "online",
        "merchantId": "20000000104111374000",
        "processorId": "1000001041103567878316507278003",
        "cardHolderName": "John Doe",
        "binCard": "545195",
        "merchantName": "Merchant MX",
        "processorName": "BillPocket Processor",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "transactionId": "454501167520825260",
        "lastFourDigits": "5480",
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        },
        "paymentBrand": "MASTERCARD",
        "subtotalIva": 0,
        "subtotalIva0": 1000,
        "currencyCode": "MXN",
        "ivaValue": 0,
        "cardCountry": "Ecuador",
        "created": 1651242220,
        "fullResponse": true,
        "transactionStatus": "APPROVAL",
        "transactionType": "PREAUTHORIZATION",
        "transactionReference": "0356c7c3-deab-4da0-8a0d-4985009ffc39",
        "acquirerBank": "BANJERCITO",
        "rules": []
    },
    "transactionReference": "0356c7c3-deab-4da0-8a0d-4985009ffc39"
}
Modified at 2026-04-15 21:23:36
Previous
7. Add a temporary charge or discount
Next
9. Capture an authorized payment Copy
Built with