Release 19.09.2025

Changelog

Enhanced Card Transaction Details

The Retrieve Card Transactions endpoint now returns transaction details in each response item. The following fields are now included:

• amount: Transaction amount in the merchant's currency.
• currency: Source currency code (ISO 4217).
• feeAmount: Fee amount charged for the transaction.
• feeCurrency: Currency of the fee amount.
• merchantName: Name of the merchant or entity involved.
• merchantCountry: Country of the merchant.
• mcc: Merchant Category Code.
• rrn: Retrieval Reference Number assigned by the processor.
• authorizationCode: Code indicating approval of the transaction.
• authorizedBy: Entity that authorized the transaction.
• declineReason: Reason for transaction decline.
• transactionAt: Date and time when the transaction actually occurred.

Card Balance Operation Response Updates

The following endpoints now return detailed response data instead of empty 204 responses:

• Top up card balance
• Withdraw card balance

Both endpoints now return a 200 status with transaction identifiers:

{
  "data": {
    "fromTransactionId": "9f283e59-21ec-4c74-ae32-156d49cd9cf2",
    "toTransactionId": "9f283e59-21ec-4c74-ae32-156d49cd9cf2"
  }
}

Provider Account Schema Refinement

The Retrieve Available Provider Accounts endpoint response structure has been updated. The cardType field has been renamed to type.

Additional Enhancements

• The Retrieve Card Details endpoint now includes activate as a possible value in the availableActions array.

• The Retrieve Account Transactions endpoint now supports the authorized status value, indicating transactions that have been approved but not yet settled.

• The Retrieve Card Transaction Details endpoint now includes the mcc (Merchant Category Code) field.