Consultar listado de transacciones v2

https://api-uat.kushkipagos.com

GET

/analytics/v2/transactions-list

Obtén una lista paginada de transacciones de un comercio específico usando la Get Transaction List v2 API. Esta versión admite tanto transacciones card present como card not present, y permite filtrar por pay-ins y pay-outs. Las transacciones se devuelven en orden descendente: las más recientes aparecen primero.

Ten en cuenta:
Las transacciones solo se pueden consultar a través de este endpoint 90 segundos después de su creación.
El número máximo de transacciones que puedes consultar por request es 600.
Si no incluyes el parámetro limit en el request, el número máximo de transacciones que se devolverán es 100.

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/analytics/v2/transactions-list?external_reference_id=undefined&processor_name=undefined&sale_ticket_number=undefined&sync_mode=undefined&payment_method=undefined&response_text=undefined&response_code=undefined&subscription_id=undefined&merchant_name=undefined&transaction_status=undefined&ice_value=undefined&iva_value=undefined&subtotal_iva0=undefined&subtotal_iva=undefined&approval_code=undefined&approved_transaction_amount=undefined&request_amount=undefined&created=undefined&card_type=undefined&merchant_id=undefined&processor_id=undefined&number_of_months=undefined&card_holder_name=undefined&transaction_type=undefined&currency_code=undefined&transaction_id=undefined&ticket_number=undefined&offset=undefined&limit=undefined&to=undefined&from=undefined' \
--header 'Private-Merchant-Id;'

Response Example

200 - Get transactions list

{
    "total": 3,
    "data": [
        {
            "masked_credit_card": "545195XXXXXX5480",
            "created": "2025-02-04T15:53:45.000Z",
            "metadata": "{\"contractID\":\"157AB\"}",
            "approved_transaction_amount": 0,
            "contact_details": {
                "document_code": "DORJ760623HNGDORJ7",
                "document_type": "RUC",
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone": "+593912345678"
            },
            "country": "Ecuador",
            "credential_alias": "Manuel Mexico",
            "credential_id": "aa39582ddf0e4fcdad6d91f0caf64e28",
            "currency_code": "USD",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Mexico",
            "payment_method": "CARD",
            "payment_submethod": "CARD NO PRESENT",
            "processor_name": "undefined",
            "processor_type": "aggregator_formal",
            "public_credential_id": "fc98ad9ee66443588be2873c89217cdd",
            "request_amount": 1000,
            "response_code": "K220",
            "response_text": "Monto de la transacción es diferente al monto de la venta inicial",
            "subtotal_iva": 0,
            "subtotal_iva0": 1000,
            "token": "47cd356ce5724d68993218d6be4834c9",
            "transaction_id": "1738684425593130452",
            "transaction_reference": "1275635a-ad34-4764-a27e-f6215b94b3c7",
            "transaction_status": "DECLINED",
            "transaction_type": "SALE",
            "bin_card": "54519515",
            "card_country": "Ecuador",
            "card_country_code": "EC",
            "card_holder_name": "Jose Perez",
            "card_type": "credit",
            "foreign_card": true,
            "issuing_bank": "Banco de la Produccion S.A. (PRODUBANCO)",
            "last_four_digits": "5480",
            "payment_brand": "Mastercard",
            "transaction_card_id": "6420c5bd-5a3f-45d2-8ac4-88de7b09958d"
        },
        {
            "masked_credit_card": "545195XXXXXX5480",
            "created": "2025-02-04T15:55:37.000Z",
            "metadata": "{\"contractID\":\"157AB\"}",
            "approved_transaction_amount": 1000,
            "contact_details": {
                "document_code": "DORJ760623HNGDORJ7",
                "document_type": "RUC",
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone": "+593912345678"
            },
            "country": "Ecuador",
            "credential_alias": "Alias1",
            "credential_id": "22c33a81f145415cb200ab8139603a51",
            "currency_code": "USD",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Mexico",
            "payment_method": "CARD",
            "payment_submethod": "CARD NO PRESENT",
            "processor_id": "6000000000172166121420424728",
            "processor_name": "Prosa Processor",
            "processor_type": "gateway",
            "public_credential_id": "d5713887dc434cc4bb873781e46e10ca",
            "request_amount": 1000,
            "response_code": "000",
            "response_text": "Transacción aprobada",
            "subtotal_iva": 0,
            "subtotal_iva0": 1000,
            "ticket_number": "029184246439606168",
            "token": "a53d40a70ead40ecb24a4c872027da5c",
            "transaction_id": "700011575252919092",
            "transaction_reference": "aa778d12-c56b-4cc2-86c8-1dea7cebe65e",
            "transaction_status": "APPROVED",
            "transaction_type": "SALE",
            "acquirer_bank": "Afirme",
            "approval_code": "000000",
            "bin_card": "54519515",
            "card_country": "Ecuador",
            "card_country_code": "EC",
            "card_holder_name": "John Doe",
            "card_type": "credit",
            "foreign_card": true,
            "issuing_bank": "Banco de la Produccion S.A. (PRODUBANCO)",
            "last_four_digits": "5480",
            "payment_brand": "Mastercard",
            "processor_merchant_id": "111",
            "taxes": {
                "agenciaDeViaje": 0,
                "iac": 0,
                "tasaAeroportuaria": 0
            },
            "transaction_card_id": "6420c5bd-5a3f-45d2-8ac4-88de7b09958d"
        },
        {
            "masked_credit_card": "545195XXXXXX5480",
            "created": "2025-02-04T15:58:44.302Z",
            "metadata": "{\"contractID\":\"157AB\"}",
            "approved_transaction_amount": 500,
            "contact_details": {
                "email": "manuel.guerrero@kushkipagos.com"
            },
            "country": "Ecuador",
            "credential_alias": "Alias1",
            "credential_id": "22c33a81f145415cb200ab8139603a51",
            "credential_metadata": null,
            "currency_code": "USD",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Mexico",
            "payment_method": "CARD",
            "payment_submethod": "CARD NO PRESENT",
            "processor_id": "6000000000172166121420424728",
            "processor_name": "Prosa Processor",
            "processor_type": "gateway",
            "public_credential_id": "d5713887dc434cc4bb873781e46e10ca",
            "request_amount": 500,
            "response_code": "000",
            "response_text": "Transacción aprobada",
            "sale_approval_code": "000000",
            "sale_ticket_number": "029184246439606168",
            "sale_transaction_type": "SALE",
            "subtotal_iva": 500,
            "subtotal_iva0": 0,
            "ticket_number": "661738684712571670",
            "transaction_id": "700011575252919092",
            "transaction_reference": "2052742c-97dc-4d8a-b7b0-27bf4eafcc0a",
            "transaction_status": "APPROVED",
            "transaction_type": "VOID",
            "tax_id": "1234567890123",
            "approval_code": null,
            "bin_card": "545195",
            "card_country": "Ecuador",
            "card_country_code": "EC",
            "card_holder_name": "John Doe",
            "card_type": "Credit",
            "foreign_card": true,
            "historical": [
                {
                    "country": "Ecuador",
                    "public_credential_id": "d5713887dc434cc4bb873781e46e10ca",
                    "subtotal_iva": 500,
                    "card_country": "Ecuador",
                    "nit": "1234567890123",
                    "processor_name": "Prosa Processor",
                    "response_text": "Transacción aprobada",
                    "sale_ticket_number": "029184246439606168",
                    "transaction_reference": "c737dd5c-fcb2-4c92-92bc-db3f79c56304",
                    "mcc_code": "5934",
                    "unique_code": null,
                    "payment_method": "card",
                    "terminal_id": "1111",
                    "transaction_id": "1738684712570726917",
                    "visibility": "visible",
                    "created": 1738684712892,
                    "iva_value": 0,
                    "sale_approval_code": "000000",
                    "merchant_name": "TW Mexico",
                    "sale_transaction_type": "SALE",
                    "transaction_type": "VOID",
                    "tax_id": "1234567890123",
                    "sync_mode": "online",
                    "credential_metadata": null,
                    "subtotal_iva0": 0,
                    "processor_type": "gateway",
                    "response_code": "000",
                    "transaction_status": "INITIALIZED",
                    "social_reason": "MANUEL MEXICO",
                    "card_holder_name": "John Doe",
                    "payment_brand": "Mastercard",
                    "request_amount": 500,
                    "processor_merchant_id": "111",
                    "merchant_id": "20000000106554380000",
                    "approved_transaction_amount": 500,
                    "merchant_category": null,
                    "currency_code": "USD",
                    "transaction_card_id": null,
                    "masked_credit_card": "545195XXXXXX5480",
                    "processor_id": "6000000000172166121420424728",
                    "foreign_card": true,
                    "last_four_digits": "5480",
                    "email": "manuel.guerrero@kushkipagos.com",
                    "contact_person": "Manuel Mexico",
                    "consortium_name": null,
                    "card_type": "Credit",
                    "ticket_number": "661738684712571670",
                    "card_country_code": "EC",
                    "credential_alias": "Alias1",
                    "processor_bank_name": "0032~BANCO INTERNACIONAL",
                    "bin_card": "545195",
                    "ice_value": 0,
                    "partial_void": true,
                    "created_iso": "2025-02-04T15:58:32.892Z",
                    "credential_id": "22c33a81f145415cb200ab8139603a51"
                }
            ],
            "last_four_digits": "5480",
            "payment_brand": "Mastercard",
            "processor_code": "000",
            "processor_merchant_id": "111",
            "processor_message": "Transacción aprobada",
            "recap": null,
            "transaction_card_id": null,
            "void_ticket_number": "661738684712571670"
        }
    ]
}

Modified at 2026-09-11 15:03:03

Analytics

Smartlinks