Capture an authorized payment

POST

/card/v1/capture

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

Capture an authorized or reauthorized card payment using the ticketNumber provided as a response of the Authorize payments request. The capture can only be done with the ticketNumber of the authorization, not of a reauthorization.

The maximum amount to be captured may be 10% higher than the total amount of the initial authorization plus the n reauthorizations made that have not been cancelled.

WARNING

Product in beta version for Colombia 🔐👨‍💻
We are working on our beta version. Stay tuned for its official release! You can also contact your account manager for more information.

Got a suggestion on this documentation? Contact Us.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Created

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-uat.kushkipagos.com/card/v1/capture' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ticketNumber": "319228478889680318",
    "amount": {
        "currency": "COP",
        "subtotalIva": 0,
        "iva": 0,
        "subtotalIva0": 20000,
        "ice": 0
    },
    "fullResponse": "v2",
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    }
}'

Response Example

201 - fullResponse v2

{
    "details": {
        "approvalCode": "000000",
        "approvedTransactionAmount": 1,
        "binInfo": {
            "bank": "BANCOLOMBIA",
            "type": "credit",
            "binCard": "545195",
            "lastFourDigits": "5480",
            "cardCountry": "Colombia"
        },
        "cardHolderName": "John Doe",
        "merchantId": "20000000105929933000",
        "merchantName": "Tu comercio Colombia",
        "paymentBrand": "Master Card",
        "preauthTransactionReference": "27eb6de0-40c7-4167-97c8-a53f3d5bf032",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "responseCode": "000",
        "responseText": "Transacción aprobada",
        "ticketNumber": "811341055296364740",
        "transactionReference": "27eb6de0-40c7-4167-97c8-a53f3d5bf032",
        "transactionType": "CAPTURE",
        "amount": {
            "currency": "COP",
            "subtotalIva": 0,
            "subtotalIva0": 1,
            "iva": 0,
            "ice": 0,
            "extraTaxes": {
                "agenciaDeViaje": 0,
                "iac": 0,
                "tasaAeroportuaria": 0
            }
        },
        "created": 1658359597000,
        "requestAmount": 59,
        "token": "2f40ee93ffee4f0cad64b79cb4025c58",
        "transactionStatus": "APPROVAL"
    },
    "ticketNumber": "811341055296364740",
    "transactionReference": "27eb6de0-40c7-4167-97c8-a53f3d5bf032"
}

Modified at 2026-04-16 23:06:23

Authorize payments

Bin Info V2

Capture an authorized payment

This functionality is available for the following models:#

Product in beta version for Colombia 🔐👨‍💻#

Request

Responses

This functionality is available for the following models:

Product in beta version for Colombia 🔐👨‍💻