Kushki Developer Portal
  1. CARD
Kushki Developer Portal
  • Back to home
  • Perú 🇵🇪
  • Bienvenidos
  • ONLINE PAYMENTS
    • 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. Capture an authorized payment
        POST
      • 8. Bin Info
        GET
      • 9. Bin Info V2
        GET
      • 10. Validate OTP
        POST
      • 5. Request deferred options
        GET
      • 2. Make a charge or deferred charge
        POST
      • 1. Request a card token
        POST
      • 8. Bin Info
        GET
      • 7. Capture an authorized payment
        POST
      • 10. Validate OTP
        POST
      • 4. Refund a transaction
        DELETE
      • 9. Bin Info V2
        GET
      • 6. Authorize payments
        POST
      • 3. Void a transaction
        DELETE
    • 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
      • 9. Capture an authorized payment
      • 7. Add a temporary charge or discount
      • 8. Authorize payments
      • 5. Cancel a recurring charge
      • 4. Make an One-click payment
      • 1. Request a recurring charge token
      • 2. Create a recurring charge
      • 10. Get recurring charge Info
      • 6. Update a recurring charge
      • 3. Update recurring charge card data
    • TRANSFER IN
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 4. Get Status
      • 2. Request a Transfer In token
      • 4. Get Status
      • 3. Init Transaction
    • CASH IN
      • 1. Request a cash in token
      • 2. Init Transaction
      • 3. Transaction Status
      • 2. Init Transaction
      • 1. Request a cash in token
      • 3. Transaction Status
    • SMARTLINKS V2
      • 1. Create a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 4. Update a Smartlink
      • 2. Get a Smartlink
      • 3. Delete a Smartlink
      • 1. Create a Smartlink
    • ANALYTICS
      • 1. Get transactions list
      • 1. Get transactions list
    • GATEWAY STATUS
      • 1. Get gateway status
      • 1. Get gateway status
    • COMMISSIONS
      • 1. Get Commission Configuration
      • 1. Get Commission Configuration
    • 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
      • 7. Regenerate a credential
      • 2. Search credentials
      • 4. Activate or deactivate
      • 3. Advanced search
      • 1. Create a credential
      • 5. Delete credential
    • PAYMENT BUTTON
      • 1. Create a payment button
      • 1. Create a payment button
  • CARD PRESENT PAYMENTS (API RAW)
    • Get BIN Info
    • Balance inquiries
    • BIN info V2
    • Request deferred options
  1. CARD

6. Authorize payments

POST
/card/v1/preAuthorization

Request

Header Params

Body Params application/json

Examples

Responses

🟠400
application/json
Body

🟢201
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/card/v1/preAuthorization' \
--header 'Private-Merchant-Id: {{PE-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "{{token}}",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 50,
        "ice": 0,
        "iva": 0,
        "currency": "PEN"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+513912345678",
            "address": "Av. Simón Bolivar 1515",
            "city": "Lima",
            "region": "Pueblo Libre",
            "country": "Perú",
            "zipCode": "15084"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+513912345678",
            "address": "Av. Simón Bolivar 1515",
            "city": "Lima",
            "region": "Pueblo Libre",
            "country": "Perú",
            "zipCode": "15084"
        }
    },
    "months": 3,
    "fullResponse": "v2"
}'
Response Response Example
400 - GL - 400 - K001 - Cuerpo de la petición inválido
{
    "code": "K001",
    "message": "Cuerpo de la petición inválido."
}
Modified at 2026-01-06 19:33:02
Previous
9. Bin Info V2
Next
3. Void a transaction
Built with