Subscription Transactions

The Subscription Transactions endpoint lets you query the full transaction history charged under a specific subscription in Mexico 🇲🇽. Use it for reconciliation, support, and billing audits — without needing to log into the Kushki Console.

ℹ️ This endpoint is available for both Acquirer and Aggregator integration models.

Quick start

GET /data/v1/subscription/{subscriptionId}?start=2026-05-01&end=2026-05-31&size=50

Parameter	In	Required	Description
`subscriptionId`	path	✅	Unique subscription identifier — returned when creating a subscription
`start`	query	Optional	Start date — `YYYY-MM-DD`. Defaults to 5 days before the request
`end`	query	Optional	End date — `YYYY-MM-DD`. Defaults to the moment the request is made
`size`	query	Optional	Max transactions to return. Default: `100`

Response structure

A successful response returns the subscription's details and a transactions array with all charges in the requested date range.

{
  "active_indicator": true,
  "subscription_code": "1725484000756000",
  "plan_name": "Plan mensual",
  "periodicity_type": "custom",
  "amount_object": {
    "currency": "MXN",
    "subtotalIva0": 500,
    "subtotalIva": 0,
    "iva": 0,
    "ice": 0
  },
  "card_holder_name": "Juan García",
  "card_type": "credit",
  "last_four_digit_code": "4242",
  "contact_details_object": {
    "email": "user@example.com",
    "firstName": "Juan",
    "lastName": "García"
  },
  "bin_info_object": {
    "bank": "BANORTE",
    "bin": "521892",
    "brand": "MASTERCARD",
    "info": {
      "country": {
        "alpha3": "MEX",
        "name": "Mexico"
      },
      "type": "credit"
    }
  },
  "merchant_code": "20000000103802320000",
  "merchant_country_name": "Mexico",
  "create_timestamp": 1760313600,
  "start_timestamp": 1760313600,
  "last_charge_timestamp": 1760313600,
  "transactions": [
    {
      "_id": "491915787351730000",
      "approved_transaction_amount": 500,
      "currency_code": "MXN",
      "response_code": "000",
      "response_description": "Transacción aprobada",
      "card_holder_name": "Juan García",
      "card_type": "credit",
      "card_country_code": "MX",
      "card_country_name": "Mexico",
      "payment_brand_name": "Mastercard",
      "payment_method_type": "CARD",
      "processor_name": "MC Processor",
      "subscription_trigger_type": "onDemand",
      "create_timestamp": 1774459991000
    }
  ]
}

Subscription fields

Field	Description
`active_indicator`	`true` if the subscription is currently active
`subscription_code`	Unique identifier for the subscription
`plan_name`	Name of the subscription plan
`periodicity_type`	Billing cycle — `monthly`, `weekly`, `annual`, `custom`
`amount_object`	Subscription charge amount and currency
`card_holder_name`	Name of the cardholder on the subscription
`card_type`	`credit` or `debit`
`last_four_digit_code`	Last 4 digits of the card
`contact_details_object`	Customer contact info (email, name)
`bin_info_object`	Card BIN metadata — bank, brand, card type, issuing country
`create_timestamp`	Unix timestamp (seconds) when the subscription was created
`start_timestamp`	Unix timestamp when the first charge was made
`last_charge_timestamp`	Unix timestamp of the most recent charge
`day_of_month`	Day of the month the subscription charges (if monthly)
`metadata_object`	Custom metadata attached to the subscription

Transaction fields

Each item in the transactions array represents a single charge:

Field	Description
`_id`	Internal transaction ID
`approved_transaction_amount`	Amount charged in MXN
`currency_code`	`MXN`
`response_code`	Processor response code (`000` = approved)
`response_description`	Human-readable response message
`card_holder_name`	Cardholder name as it appears on the transaction
`card_type`	`credit` or `debit`
`card_country_code`	ISO 3166-1 alpha-2 code of the card's issuing country
`payment_brand_name`	Card network (Mastercard, Visa, etc.)
`payment_method_type`	`CARD`
`processor_name`	Name of the acquiring processor
`approval_code`	Bank authorization code
`subscription_trigger_type`	How the charge was triggered — `onDemand`, `automatic`
`create_timestamp`	Unix timestamp (milliseconds) of the transaction
`merchant_name`	Merchant name for the charge
`metadata_object`	Custom metadata attached to the transaction

Authentication

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Get Subscription Transactions

Retrieve the details and full transaction history of a subscription, filtered by date range.

Got a suggestion on this documentation? Contact us.

Quick start#

Response structure#

Subscription fields#

Transaction fields#

Authentication#

Using the API#