Skip to main content

Transaction Fields

For compatibility, the MDX Real Time API accepts ISO 8601 dates with timestamps, but timestamp information is ignored.
The MDX On Demand API does not accept timestamps on ISO 8601 dates.
Field NameData TypeDescription
account_guidStringUnique identifier for the account this transaction belongs to. Defined by MX.
account_idStringPartner-defined unique identifier for the account.
amountDecimalUnsigned transaction amount. Type determines effect on account. Max Length 10,2.
category_guidStringUnique identifier for transaction category. Defined by MX. Matches Nexus API.
category_nameStringHuman-readable category name. May be null.
categoryStringEnumerated category value. If invalid or missing, MX auto-categorizes.
check_imageStringBase64 data URI for check image (png/jpg/jpeg).
check_numberStringCheck number.
currency_codeStringISO 4217 three-character currency code.
descriptionStringHuman-readable transaction description. Max length 1024.
guidStringUnique identifier for the transaction. Defined by MX.
idStringPartner-defined unique transaction identifier. Cannot start with TRN-. Max Length 1024.
is_internationalBooleanIndicates whether transaction is international.
latitudeDecimalLatitude of transaction location (signed decimal).
localized_descriptionStringLocal-language transaction description.
localized_memoStringLocal-language memo.
longitudeDecimalLongitude of transaction location (signed decimal).
member_guidStringUnique identifier for member. Defined by MX.
member_idStringPartner-defined member identifier.
memoStringAdditional transaction notes. Max length 1024.
merchant_category_codeStringMerchant category code.
merchant_guidStringUnique merchant identifier. Defined by MX.
merchant_location_guidStringUnique merchant location identifier. Defined by MX.
metadataStringPartner-defined metadata for the transaction.
posted_atIntegerDate/time transaction was posted (Unix epoch UTC). Required if POSTED.
posted_onStringPosted date. Required if POSTED when posted_at not used.
running_balanceDecimalAccount balance after transaction (POSTED only).
statusStringTransaction status: PENDING or POSTED.
transacted_atIntegerDate/time transaction occurred (Unix epoch UTC).
transacted_onStringDate transaction occurred.
typeStringTransaction type: DEBIT or CREDIT.
user_guidStringUnique user identifier. Defined by MX.
user_idStringPartner-defined user identifier.