Kushki Developer Portal
  1. CARD
Kushki Developer Portal
  • Back to home
  • México 🇲🇽
  • Bienvenidos
  • ONLINE PAYMENTS
    • CARD
      • CARD
      • 1. Request a card token
        POST
      • 2. Make a charge or deferred charge
        POST
      • 3. Void a transaction
        DELETE
      • 4. Refund a transaction
        DELETE
      • 5. Request deferred options
        GET
      • 6. Authorize payments
        POST
      • 7. Reauthorize payments
        POST
      • 8. Capture an authorized payment
        POST
      • 9. Bin Info
        GET
      • 10. Bin Info V2
        GET
      • 11. Validate OTP
        POST
      • 12. Verify Account
        POST
      • 12. Verify Account
        POST
      • 6. Authorize payments
        POST
      • 10. Bin Info V2
        GET
      • 8. Capture an authorized payment
        POST
      • 3. Void a transaction
        DELETE
      • 4. Refund a transaction
        DELETE
      • 7. Reauthorize payments
        POST
      • 1. Request a card token
        POST
      • 9. Bin Info
        GET
      • 5. Request deferred options
        GET
      • 2. Make a charge or deferred charge
        POST
      • 11. Validate OTP
        POST
    • 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
      • 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 Copy
      • 9. Capture an authorized payment Copy
      • 10. Get recurring charge Info
      • 1. Request a recurring charge token
      • 8. Authorize payments Copy
      • 3. Update recurring charge card data
      • 6. Update a recurring charge
      • 10. Get recurring charge Info
      • 2. Create a recurring charge
      • 5. Cancel a recurring charge
      • 9. Capture an authorized payment Copy
      • 4. Make an One-click payment
      • 7. Add a temporary charge or discount
    • 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 (API RAW)
    • Single payment
    • Get BIN Info
    • BIN info V2
    • Request deferred options
    • Transaction Search
  • 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
  1. CARD

6. Authorize payments

POST
/card/v1/preAuthorization

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 '/card/v1/preAuthorization' \
--header 'Private-Merchant-Id: {{MX-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "{{token}}",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 1000,
        "ice": 0,
        "iva": 0,
        "currency": "MXN"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+523912345678",
            "address1": "Eloy Alfaro 139 y Catalina Aldaz",
            "address2": "centro 123",
            "city": "Querétaro",
            "region": "Centro",
            "country": "México",
            "zipCode": "170402"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+523912345678",
            "address1": "Eloy Alfaro 139 y Catalina Aldaz",
            "address2": "centro 123",
            "city": "Querétaro",
            "region": "Centro",
            "country": "México",
            "zipCode": "170402"
        }
    },
    "fullResponse": "v2"
}'
Response Response Example
201 - 201 - fullResponse true
{
    "ticketNumber": "573118394633955756",
    "details": {
        "token": "84a233a4145e43d0acc2d5db87c4f50f",
        "orderDetails": {
            "siteDomain": "example.com",
            "shippingDetails": {
                "name": "John Doe",
                "phone": "+593912345678",
                "address1": "Eloy Alfaro 139 y Catalina Aldaz",
                "address2": "centro 123",
                "city": "Querétaro",
                "region": "Centro",
                "country": "México",
                "zipCode": "170402"
            },
            "billingDetails": {
                "name": "John Doe",
                "phone": "+593912345678",
                "address1": "Eloy Alfaro 139 y Catalina Aldaz",
                "address2": "centro 123",
                "city": "Querétaro",
                "region": "Centro",
                "country": "México",
                "zipCode": "170402"
            }
        },
        "fullResponse": true,
        "currencyCode": "MXN",
        "ip": "186.28.11.9",
        "maskedCardNumber": "545195XXXXXX5480",
        "approvedTransactionAmount": 1000,
        "acquirerBank": "BANJERCITO",
        "subtotalIva": 0,
        "subtotalIva0": 1000,
        "created": 1650899159000,
        "responseCode": "000",
        "transactionType": "PREAUTHORIZATION",
        "approvalCode": "000000",
        "transactionStatus": "APPROVAL",
        "syncMode": "online",
        "merchantId": "20000000104111374000",
        "processorType": "gateway",
        "transactionId": "479187459268487764",
        "responseText": "Transacción aprobada",
        "cardHolderName": "John Doe",
        "lastFourDigits": "5480",
        "binCard": "545195",
        "paymentBrand": "Master Card",
        "cardType": "credit",
        "iceValue": 0,
        "requestAmount": 1000,
        "ivaValue": 0,
        "merchantName": "Merchant MX",
        "processorName": "Elavon Processor",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "transactionReference": "095f4bfe-5334-4012-8289-d0c058d108c5",
        "issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
        "country": "Mexico",
        "foreignCard": true,
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        },
        "cardCountry": "Ecuador",
        "rules": []
    },
    "transactionReference": "095f4bfe-5334-4012-8289-d0c058d108c5"
}
Modified at 2026-01-06 19:33:02
Previous
12. Verify Account
Next
10. Bin Info V2
Built with