Get transactions list v2

GET

/analytics/v2/transactions-list

Retrieve a paginated list of transactions for a specific merchant using the Get Transaction List v2 API. This version supports both card-present and card-not-present transactions, as well as filtering by pay-ins and pay-outs. Transactions are returned in descending order, with the most recent ones appearing first.

To Keep in mind:
Transactions can only be queried through this endpoint 90 seconds after their creation.
The maximum number of transactions you can query per request is 600.
In case the limit parameter is not included in the request, the maximum number of transations that will be returned is 100.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/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": "DNI",
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone": "+51912345678"
            },
            "country": "Peru",
            "credential_alias": "Manuel Peru",
            "credential_id": "aa39582ddf0e4fcdad6d91f0caf64e28",
            "currency_code": "PEN",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Peru",
            "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": "Pery",
            "card_country_code": "PE",
            "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": "DNI",
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone": "+51912345678"
            },
            "country": "Peru",
            "credential_alias": "Alias1",
            "credential_id": "22c33a81f145415cb200ab8139603a51",
            "currency_code": "PEN",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Peru",
            "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": "Peru",
            "card_country_code": "PE",
            "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": "Peru",
            "credential_alias": "Alias1",
            "credential_id": "22c33a81f145415cb200ab8139603a51",
            "credential_metadata": null,
            "currency_code": "PEN",
            "ice_value": 0,
            "iva_value": 0,
            "merchant_id": "20000000106554380000",
            "merchant_name": "TW Peru",
            "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": "Peru",
            "card_country_code": "PE",
            "card_holder_name": "John Doe",
            "card_type": "Credit",
            "foreign_card": true,
            "historical": [
                {
                    "country": "Peru",
                    "public_credential_id": "d5713887dc434cc4bb873781e46e10ca",
                    "subtotal_iva": 500,
                    "card_country": "Peru",
                    "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 Peru",
                    "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 PERU",
                    "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": "PEN",
                    "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 Peru",
                    "consortium_name": null,
                    "card_type": "Credit",
                    "ticket_number": "661738684712571670",
                    "card_country_code": "PE",
                    "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-07-28 20:50:29

Get transactions list v1

Chargebacks