Balance inquiries
Deprecated
POST
/pos/v1/transaction
Use the available filters to search for a specific transaction.
Important!
This will return a maximum of 10,000 transactions.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/pos/v1/transaction' \
--header 'Private-Credential-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"card": {
"card_holder_name": "John Doe"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "MXN",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 0
},
"country": "MEX",
"cvm_type": "none",
"is_cashback": false,
"is_deferred": false,
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.26",
"location": {
"latitude": -0.22480833333333333,
"longitude": -78.487955
},
"has_print": true,
"terminal_id": "PB04216R20537"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600004",
"enc_track2": "BC89E00A33EB8F86B7C636404975A28AB19E68414779CA4D"
},
"enc_tlv": "91C6E9B4A6993F7451D912264EB3051378F6284B7810FE1BD908163AFDC4A6E62136DDE4F79F577891B12F5C8F61435B773BB92E02664F9D869983B1E2F65EAC3FC95911C0FB915B56871118879FE2EEFA392A7D8F80A5F11FB9A105354AEF52605B7309A1947F3AD7B02E906E75EBE7961DC6A4ACAB77CE7752ACE9DA465DD7734BCE410A58273AB8FB6A42E2CD08BAA1485E71EE4A7AC170C9617666C724147AE6935441199AEC",
"pin_ksn": "FFFF4357486333600004",
"pin_block": "77745DD18B48D49F",
"reading_type": "NFC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "-1",
"document_number": "",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "balanceInquiry",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a"
}'Response Response Example
200 - example-1
{
"items": [
{
"amount": {
"extra_taxes": {}
},
"deferred": {},
"merchant_id": "20000000106781760000",
"payment_brand": "VISA",
"pos_details": {},
"reading_type": "ICC",
"transaction_reference": "Test_Webhook_PREAUTH_D",
"transaction_status": "DECLINED",
"transaction_type": "PREAUTH"
}
]
}Modified at 2026-01-30 00:55:34