MOmollie
Accounts API

Get transaction

Changed on

🔒 Restricted access

This API is currently only available to Mollie's authorized partners via OAuth. Direct access for individual businesses isn't available yet, but it's on our roadmap — check back here for updates.

Retrieve a single transaction object by its transaction ID. This allows you to check the details, amount, counterparty, and balance impact of a specific transaction.

get/v2/business-accounts/accounts/{businessAccountId}/transactions/{transactionId}

Request

  • Base URL
    https://api.mollie.com
  • URL
    https://api.mollie.com/v2/business-accounts/accounts/{businessAccountId}/transactions/{transactionId}
  • Auth
    OAuth 2
    Authorization code: https://my.mollie.com/oauth2/authorize
    Token URL: https://api.mollie.com/oauth2/tokens scopes: business-accounts.read

Query parameters

testmodeboolean

Most API credentials are specifically created for either live mode or test mode. In those cases the testmode query parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting the testmode query parameter to true.

Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

Response

The transaction object.

resourcestring required

Indicates the response contains a business account transaction object. Will always contain the string business-account-transaction for this endpoint.

idstring required
businessAccountIdstring required
creditDebitIndicator'credit' | 'debit' required

Indicates whether the entry is a credit or debit from the perspective of the account holder.

type'card-payment' | 'bank-transfer' | 'psp-transfer' | 'internal-transfer' | 'ideal-payment' | 'fee' | 'correction' | 'direct-debit' | 'direct-debit-refund' | 'rewards-payout' required

Indicates what kind of transaction this is.

We may introduce new transaction types as we expand the product. We recommend building your integration to handle unexpected values gracefully, so nothing breaks when that happens.

descriptionstring nullable

A short description of the transaction.

processedAtstring nullable

The date and time when the transaction was processed, in ISO 8601 format.

mode'live' | 'test' required

Whether this entity was created in live mode or in test mode.

createdAtstring required

The entity's date and time of creation, in ISO 8601 format.

Example response

{
  "resource": "business-account-transaction",
  "id": "batr_87GByBuj4UCcUTEbs6aGJ",
  "businessAccountId": "ba_nopqrstuvwxyz23456789A",
  "creditDebitIndicator": "debit",
  "type": "bank-transfer",
  "amount": {
    "currency": "EUR",
    "value": "10.00"
  },
  "description": "Payment for services",
  "counterparty": {
    "identifier": "NL02ABNA0123456789",
    "name": "Beneficiary Name"
  },
  "afterBalance": {
    "total": {
      "currency": "EUR",
      "value": "10.00"
    }
  },
  "processedAt": "2025-02-26T08:00:00+00:00",
  "mode": "live",
  "createdAt": "2024-03-20T09:13:37+00:00"
}

Changes

  • 8817dd47862fRevision changes
    • warning

      added the new rewards-payout enum value to the //// response property for the response status

  • 7cab62b21830Revision changes
    • info

      added the non-success response with the status