SettlementTransaction | ePay documentation

Settlement transactions gives pr. transaction insight into the fees paid to the acquirer, scheme and network.

idstring

The ID of the settlement transaction

Format:

uuid

Example:

"019b3130-5d58-716d-8881-9a3ec506017f"

settlementTransferIdstring

The ID of the settlement transfer

Format:

uuid

Example:

"019b3130-5d58-716d-8881-9a3ec506017f"

transactionIdstring

Nullable

The ID of the ePay transaction. Can be null if the data cannot be linked to an ePay transaction.

Example:

"50947727185442134"

agreementIdstring

The acquirer MID this transaction was executed on

Example:

"R01234"

merchantReferencestring

The merchant provided reference value

Example:

"ref-settlement-6"

acquirerReferencestring

The acquirer provided reference value

Example:

"acq-tx-settlement-6"

postingDatestring

The posting date of the transaction as registered by the acquirer

Format:

date

Example:

"2025-01-01"

settlementNetAmountstring

The net settlement amount after adjustments and fees.

Example:

"100.01"

settlementCurrencystring

The currency the transaction was settle in. This can be different than the original transaction amount, if your payments are settled in a single currency.

Example:

"DKK"

List of adjustments/fees applied to the transaction before the amount is paid out. This contains all the fees the acquirer, network and issuer has taken for processing your transaction. These fees are not related to nor charged by ePay.

Array [

typestring

The type of adjustment, this tells you reason for the adjust and who the money is paid to.

The types [RESERVE, ADJUSTMENT, FEE] is used for transfer adjustments.

RESERVE: The amounts deducted and released from the merchant’s collateral

FEE: Fees charged for different services provided by the acquirer (e.g., wire transfer fee).

ADJUSTMENT: Amounts debited or credited to the merchant to adjust the merchant balance.

The types [ACQUIRER_FEE, INTERCHANGE_FEE, SCHEME_FEE] is used for transaction adjustments.

ACQUIRER_FEE: Fees that is charged by and goes to the acquirer.

INTERCHANGE_FEE: Fees that goes to the issuing bank of the paying card.

SCHEME_FEE: Fees that goes to the scheme network such as Visa and Mastercard.

Possible values:

"RESERVE""ADJUSTMENT""FEE""ACQUIRER_FEE""INTERCHANGE_FEE""SCHEME_FEE"

Example:

"FEE"

amountstring

Numeric string, negative for fees

Example:

"-1.00"

descriptionstring

Human-readable description

Example:

"discount_rate"

]

createdAtstring

The creation time of the data at ePay.

Format:

date-time

Example:

"2025-12-18T11:20:11Z"

SettlementTransaction

{  "id": "019b3130-5d58-716d-8881-9a3ec506017f",  "settlementTransferId": "019b3130-5d58-716d-8881-9a3ec506017f",  "transactionId": "50947727185442134",  "agreementId": "R01234",  "merchantReference": "ref-settlement-6",  "acquirerReference": "acq-tx-settlement-6",  "postingDate": "2025-01-01",  "settlementNetAmount": "100.01",  "settlementCurrency": "DKK",  "adjustments": [    {      "type": "FEE",      "amount": "-1.00",      "description": "discount_rate"    }  ],  "createdAt": "2025-12-18T11:20:11Z"}