Kushki Developer Portal
  1. CARD
Kushki Developer Portal
  • Back to home
  • Chile 🇨🇱
  • 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
      • 11. Voucher
        GET
      • 5. Request deferred options
        GET
      • 8. Bin Info
        GET
      • 10. Validate OTP
        POST
      • 3. Void a transaction
        DELETE
      • 4. Refund a transaction
        DELETE
      • 6. Authorize payments
        POST
      • 1. Request a card token
        POST
      • 7. Capture an authorized payment
        POST
      • 11. Voucher
        GET
      • 2. Make a charge or deferred charge
        POST
      • 9. Bin Info V2
        GET
    • 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. Get Bank List
      • 2. Request a Transfer In token
      • 3. Init Transaction
      • 4. Get Status
      • 1. Get Bank List
      • 4. Get Status
      • 2. Request a Transfer In token
      • 3. Init Transaction
    • TRANSFER OUT
      • 1. Get Bank List
      • 2. Request a Transfer Out token
      • 3. Init Transaction
      • 4. Get Status
      • 5. Wallet Balance
      • 2. Request a Transfer Out token
      • 1. Get Bank List
      • 5. Wallet Balance
      • 3. Init Transaction
      • 4. Get Status
    • 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
      • 3. Update recurring charge card data
      • 7. Add a temporary charge or discount
      • 10. Get recurring charge Info
      • 5. Cancel a recurring charge
      • 6. Update a recurring charge
      • 4. Make an One-click payment
      • 9. Capture an authorized payment
      • 8. Authorize payments
      • 2. Create a recurring charge
      • 1. Request a recurring charge token
    • 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
      • 3. Delete a Smartlink
      • 4. Update a Smartlink
      • 1. Create a Smartlink
      • 2. Get 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
      • 6. Update credential
      • 5. Delete credential
      • 4. Activate or deactivate
      • 2. Search credentials
      • 1. Create a credential
      • 3. Advanced search
      • 7. Regenerate 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
    • ASYNC CARD RECURRING CHARGES
      • 1. Request a token
      • 2. Init an async card recurring charge
      • 3. Authorize payments
      • 4. Capture an authorized payment
      • 2. Init an async card recurring charge
      • 4. Capture an authorized payment
      • 1. Request a token
      • 3. Authorize payments
    • CARD ASYNC
      • 1. Request a card async token
      • 2. Init Transaction
      • 3. Authorize payments Copy
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 4. Capture an authorized payment Copy
      • 5. Get Status
      • 3. Authorize payments Copy
      • 2. Init Transaction
      • 1. Request a card async token
  • CARD PRESENT PAYMENTS (API RAW)
    • Single payment
  1. CARD

4. Refund a transaction

DELETE
/v1/refund/{{ticketNumber}}

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 DELETE '/v1/refund/{{ticketNumber}}' \
--header 'Private-Merchant-Id: {{CL-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fullResponse": true,
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 5000,
        "ice": 0,
        "iva": 0,
        "currency": "CLP"
    }
}'
Response Response Example
201 - 201 - fullResponse true
{
    "ticketNumber": "661657328731639416",
    "details": {
        "acquirerBank": "Transbank",
        "saleTicketNumber": "751565500824396262",
        "integrationMethod": "mall",
        "processorName": "Transbank Processor",
        "paymentBrand": "Master Card",
        "socialReason": "Merchant CL",
        "cardType": "credit",
        "currencyCode": "CLP",
        "country": "Chile",
        "responseCode": "000",
        "categoryMerchant": "Medium",
        "publicCredentialId": "4e3f2b826a4245a6ad51c8a364462bb8",
        "subtotalIva": 0,
        "taxId": "1234555",
        "lastFourDigits": "5480",
        "secureId": "98e93503-09bf-426c-b55d-2f3de4a45e7c",
        "syncMode": "online",
        "merchantName": "Merchant CL",
        "credentialAlias": "Merchant CL",
        "productDetails": {
            "product": [
                {
                    "id": "198952AB",
                    "quantity": 1,
                    "title": "eBook Digital Services",
                    "sku": "10101042",
                    "price": 2000
                },
                {
                    "id": "198953AB",
                    "quantity": 1,
                    "title": "eBook Virtual Selling",
                    "sku": "004834GQ",
                    "price": 3000
                }
            ]
        },
        "subtotalIva0": 5000,
        "maskedCardNumber": "545195XXXXXX5480",
        "merchantId": "20000000108297093000",
        "approvedTransactionAmount": 5000,
        "metadata": {
            "contractID": "157AB"
        },
        "secureService": "KushkiOTP",
        "responseText": "Transacción aprobada",
        "transactionId": "1657328731628088098",
        "fullResponse": true,
        "binCard": "545195",
        "ivaValue": 0,
        "buyOrder": "22099320781",
        "iceValue": 0,
        "issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
        "token": "b022e33631764a9db16aecbb29ee175e",
        "foreignCard": true,
        "contactDetails": {
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "+563912345678",
            "documentType": "RUT",
            "documentNumber": "1234567890",
            "email": "user@example.com"
        },
        "processorId": "1000001037099579085016497235408",
        "requestAmount": 5000,
        "cardHolderName": "John Doe",
        "userAgent": "PostmanRuntime/7.29.0",
        "ip": "187.191.8.203",
        "transactionStatus": "INITIALIZED",
        "processorType": "aggregator_formal",
        "created": 1657328644000,
        "approvalCode": "000000",
        "tokenType": "transaction",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "credentialId": "2ad22b9716704862a2bd827ec887c5b6",
        "orderDetails": {
            "shippingDetails": {
                "zipcode": "9200000",
                "country": "Chile",
                "phone": "+563912345678",
                "address2": "Los Cerrillos",
                "city": "Santiago",
                "address1": "Av. Pedro Aguirre Cerda 6100",
                "name": "John Doe",
                "region": "Metropolitana"
            },
            "billingDetails": {
                "zipcode": "9200000",
                "country": "Chile",
                "phone": "+563912345678",
                "address2": "Los Cerrillos",
                "city": "Santiago",
                "address1": "Av. Pedro Aguirre Cerda 6100",
                "name": "John Doe",
                "region": "Metropolitana"
            },
            "siteDomain": "example.com"
        },
        "transactionReference": "2521fe14-cd36-43b1-bcc4-ff3057581e89",
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        },
        "maskedCreditCard": "545195XXXX5480",
        "transactionType": "VOID"
    }
}
Modified at 2026-01-06 19:33:02
Previous
3. Void a transaction
Next
6. Authorize payments
Built with