Retrieve processed transactions via API

Use the Processed Transactions API to retrieve data about card-present and card-not-present transactions processed through external platforms.

Processed Transactions are transactions executed via external payment systems and reported back to the platform. They may be initiated at physical terminals (card-present) or online (card-not-present), and are available for querying by ARN, unique ID, or date ranges.

Retrieve a single transaction by ARN or ID

You can retrieve a single transaction by providing either the ARN (Acquirer Reference Number) or the transaction’s unique ID.

Request example (ARN)

<processed_transaction_request>
  <arn>74537604221431003881865</arn>
</processed_transaction_request>

Request example (Unique ID)

<processed_transaction_request>
  <unique_id>53b1f5eacc9e4d3a3afebb4e993fe962</unique_id>
</processed_transaction_request>

Retrieve transactions by date or post date

To retrieve transactions within a specific time period, use one of the following:

by_date – Based on transaction creation date
by_post_date – Based on posting date

Each response returns up to 100 transactions per page.

Request example

<processed_transaction_request>
  <start_date>2025-01-01</start_date>
  <end_date>2025-01-31</end_date>
  <batch_number>2065063</batch_number>
  <batch_slip_number>366236636</batch_slip_number>
  <deposit_slip_number>224234433</deposit_slip_number>
  <externally_processed>external</externally_processed>
  <processing_type>all</processing_type>
  <page>1</page>
</processed_transaction_request>

Request parameters

Parameter	Required	Format	Description
`start_date`	Yes	yyyy-mm-dd	Start of the requested date range
`end_date`	No	yyyy-mm-dd	End of the requested date range
`page`	No	integer	Page number (default: 1)
`per_page`	No	integer	Number of results per page (default: 100)
`batch_number`	No	string(255)	Batch number (only for `by_post_date` calls)
`batch_slip_number`	No	string(255)	Batch slip number (only for `by_post_date` calls)
`deposit_slip_number`	No	string(255)	Deposit slip number (only for `by_post_date` calls)
`externally_processed`	No	string	`genesis`, `external`, or `all` (default: `genesis`)
`processing_type`	No	string	`card_present`, `card_not_present`, or `all` (default: `all`)

Response example

Below is an example of a successful response:

<processed_transaction_response>
  <merchant_number>124000000006698</merchant_number>
  <batch_number>eMP</batch_number>
  <transaction_id>a1qf12e81eb23d0e00ffb85b1db7d152</transaction_id>
  <transaction_date>2025-06-01 12:00:00 UTC</transaction_date>
  <post_date>2025-06-01</post_date>
  <terminal_id>53b1f5eacc9eddda3afebb4e993fe962</terminal_id>
  <auth_code>09117B</auth_code>
  <currency>USD</currency>
  <amount>3690</amount>
  <merchant_transaction_reference>b76e9a54bdc99b3</merchant_transaction_reference>
  <card_brand>MC World Signia</card_brand>
  <card_number>420000…0000</card_number>
  <bin_country>124</bin_country>
  <service_type_desc>Credit Card</service_type_desc>
  <merchant_country>826</merchant_country>
  <area_of_event>Foreign – MASTER</area_of_event>
  <cross_rate>1</cross_rate>
  <card_scheme>Mastercard</card_scheme>
  <capture_method>ICC, contactless, no cvm</capture_method>
  <unique_id>b76e9a54bdc99b338068681727ed5e240000</unique_id>
  <type>purchase</type>
  <card_present>false</card_present>
  <deposit_slip_number>60506291293</deposit_slip_number>
  <batch_slip_number>60506282664</batch_slip_number>
  <arn>85301169244934771128812</arn>
</processed_transaction_response>

Response parameters

Parameter	Type	Description
`merchant_number`	string	Merchant number
`batch_number`	string	Batch number
`transaction_id`	string	Merchant transaction ID (card-not-present only)
`transaction_date`	string	Date and time of transaction
`post_date`	string	Posting date
`terminal_id`	string	Terminal ID
`auth_code`	string	Authorization code
`currency`	string	Transaction currency
`amount`	integer	Transaction amount (in minor units)
`merchant_transaction_reference`	string	Merchant’s reference number
`card_brand`	string	Card brand
`card_number`	string	Masked card number
`bin_country`	string	BIN issuing country (ISO)
`service_type_desc`	string	Service type (e.g. Credit Card)
`merchant_country`	string	Merchant’s country (ISO)
`area_of_event`	string	Event area (e.g. Foreign – MASTER)
`cross_rate`	float	FX conversion rate
`card_scheme`	string	Scheme (e.g. Mastercard, Visa)
`capture_method`	string	Transaction capture method
`unique_id`	string	Unique transaction ID
`type`	string	Transaction type (e.g. `purchase`)
`card_present`	boolean	Whether the card was physically present
`deposit_slip_number`	string	Deposit slip number
`batch_slip_number`	string	Batch slip number
`arn`	string	Acquirer reference number

Was this page helpful?