Refund a transaction

Refund service is available in Colombia 🇨🇴.

Refund a previously authorized transaction identified by its transaction_reference number. The transaction reference is provided when a charge is successful.

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

Cardless operations

You can perform a refund without requiring the reading of the card. Below you will find out how you can carry out a cardless operation:

NOTE: You can also check the information for a cardless reauthorization, capture or void.

To perform an operation without a card it is required to send the omit_card field with the value of true in the request. The fields required for a cardless operation are the following:

PROPERTY	TYPE	Allowed values
`amount`	`Object`
`transaction_mode`	`String`	`Authorization`
`transaction_type`	`String`	`refund`
`client_transaction_id`	`String`
`transaction_reference`	`String`
`omit_card`	`Boolean`	`true`

Example of a cardless operation

To perform a cardless operation, the omit_card field is sent with the value of true and then the other non-required fields are omitted:

{
    "amount": {
        "currency": "COP",
        "iva": 0.0,
        "subtotal_iva": 0.0,
        "subtotal_iva0": 600
    },
    "transaction_mode": "Authorization",
    "transaction_type": "refund",
    "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
    "transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
    "omit_card": true
}

curl --location 'https://api-uat.kushkipagos.com/pos/v1/refund' \ --header 'Private-Credential-Id;' \ --header 'Content-Type: application/json' \ --data '{ "amount": { "currency": "COP", "iva": 0, "subtotal_iva": 0, "subtotal_iva0": 600, "tip": 0, "extra_taxes": { "airport_tax": 0, "iac": 0, "ice": 0, "travel_agency": 0 } }, "card_details": { "enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29", "pin_ksn": "FFFF4357486333600002", "reading_type": "ICC", "tracks": { "enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8", "track_ksn": "FFFF4357486333600002" } }, "card": { "card_holder_name": "CUST IMP MC 103" }, "contact_details": { "document_number": "", "document_type": "-1", "email": "", "first_name": "", "last_name": "", "second_last_name": "", "phone_number": "" }, "pos_details": { "terminal_id": "PB04216R20537", "brand": "SUNMI", "location": { "latitude": 4.711, "longitude": -74.0721 }, "model": "P2-EU", "version": "Kushki SunmiV1.1.26", "has_print": true }, "country": "COL", "is_deferred": false, "client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a", "transaction_type": "refund", "transaction_mode": "Authorization", "is_cashback": false, "cvm_type": "none" }'

{ "additional_amounts": { "account_type": "", "amount": 0, "amount_type": "", "card_type": "", "currency_code": "" }, "authorized_amount": 500, "cvm_type": "", "F11": "", "franchise": "PROSA", "kushki_response": { "code": "000", "message": "Approved or completed Successfully." }, "message_fields": { "F38": "211039", "F39": "00" }, "transaction_reference": "f35dfb98-3a41-4192-9e92-41d29ed12a81", "ticket_number": "111727462978861299", "transaction_status": "APPROVAL", "transaction_type": "Refund" }

Cardless operations

Example of a cardless operation

Request

Responses

Refund a transaction

Cardless operations#

Example of a cardless operation#

Request

Responses

Cardless operations

Example of a cardless operation