Refund a transaction

DELETE

/v1/refund/{ticketNumber}

This functionality is available for the following models:
☑ Acquirer
☑ Aggregator

Refund a transaction identified by its ticketNumber. The ticketNumber is provided when a charge or a deferred charge is successful. Remember that the refund process is semi-automatic, so the confirmation you are receiving is to confirm you that the process has begun successfully.

Partial refunds

For partial refunds it is necessary to send the amount object.

Partial refunds are only available in Colombia, Chile, Mexico and Peru

Partial refund request example

{
  "fullResponse": "v2",
  "amount": {
    "subtotalIva": 8737,
    "subtotalIva0": 9976,
    "ice": 2099,
    "iva": 8967,
    "currency": "COP"
  }
}

WARNING

Got a suggestion on this documentation? Contact Us.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Created

Body

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

webhooksTotal refundPartial refund

curl --location --request DELETE 'https://api-uat.kushkipagos.com/v1/refund/' \
--header 'Private-Merchant-Id;' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fullResponse": "v2",
    "amount": {
        "subtotalIva": 500,
        "subtotalIva0": 0,
        "ice": 0,
        "iva": 0,
        "currency": "COP"
    },
    "webhooks": [
        {
            "events": [
                "approvedTransaction"
            ],
            "headers": [
                {
                    "label": "json",
                    "value": "12"
                }
            ],
            "urls": [
                "https://eof2hhkrta4ooo1.m.pipedream.net"
            ]
        }
    ]
}'

Response Example

201 - Refund a transaction

{
    "ticketNumber": "661646369681536731",
    "transactionReference": "14d01391-cb66-4b90-bcae-6e3e6b5b2786"
}

Modified at 2026-04-15 21:33:35

Reauthorize payments

Void a transaction

Refund a transaction

This functionality is available for the following models:#

Partial refunds#

Partial refund request example#

Request

Responses

This functionality is available for the following models:

Partial refunds

Partial refund request example