Settlements report

This report provides a comprehensive breakdown of all transaction-level movements and associated costs that impact your merchant settlement balance.

This report provides a unified, standardized view of the transaction lifecycle and fee structures for both orchestrator and non-orchestrator users. By mapping complex provider data into granular fields—including SETTLEMENT_AMOUNT, FX_RATE, and specific FEE_TYPE categories—it offers full transparency into every movement of funds.

Columns

ColumnTypeDescription
workspace_idVARCHARWorkspace identifier mapped from the merchant, used for Payrails reporting.
merchant_idVARCHARUnique identifier of the merchant.
provider_nameVARCHARProvider who processed the payment.
acquirerVARCHARAcqurier which settled the payment.
provider_merchant_accountVARCHARThe identifier of merchant account with a provider.
provider_payment_referenceVARCHARThe provider payment identifier.
created_atTIMESTAMPDate when transaction has been created.
settled_atTIMESTAMPDate when transaction has been settled.
disbursed_atTIMESTAMPDate when transaction has been disbursed to merchant.
timezoneVARCHARThe timezone of date fields.
provider_transaction_referenceVARCHARThe provider transaction identifier.
other_transaction_referencesVARCHARStringified JSON of additional PSP-specific identifiers
transaction_typeVARCHARType of transaction / money movement, values: capture, chargeback, fee, partial capture, payout, payout returned, refund.
fee_typeVARCHARFee category for transaction type fee, values: paypal fee, scheme fee, interchange, psp add-on, processing fee, chargeback.
fee_detailsVARCHARFee details for transaction type fee.
decline_reasonVARCHARReason why the transaction was not processed successfully.
transaction_currencyVARCHARThe 3-letter ISO code that identifies the currency of the transaction.
transaction_amountFLOATThe transaction amount, expressed in the transaction currency.
settlement_currencyVARCHARThe 3-letter ISO code that identifies the currency of the settlement.
settlement_amountFLOATThe transaction amount, expressed in the settlement currency.
fx_rateFLOATTransaction to settlement currency exchange rate.
transaction_amount_eurFLOATThe transaction amount, expressed in EUR.
settlement_amount_eurFLOATThe settlement amount, expressed in the EUR.
reporting_currencyVARCHARThree-letter ISO currency code, in uppercase which was selected by the merchant for reporting.
transaction_amount_reporting_currencyFLOATThe transaction amount, expressed in the merchant reporting currency.
settlement_amount_reporting_currencyFLOATThe settlement amount, expressed in the merchant reporting currency.
provider_customer_referenceVARCHARPSP-native identifier of the customer.
payment_methodVARCHARPayment method, values: card, paypal_account.
card_typeVARCHARCard type, values: credit, debit, notset, prepaid.
card_networkVARCHARCard network that supports the card, e.g. Visa, Mastercard, American Express. Card only.
card_binVARCHARThe payment method’s Bank Identification Number (BIN).
card_issuerVARCHARThe bank that issued the customer’s card. This will return an empty string for alternative payment methods such as Android Pay or Apple Pay.
card_issuer_countryVARCHARName of the country that issued the card.
card_issuer_regionVARCHARRegion of the country that issued the card.
provider_payout_referenceVARCHARThe identifier of the funds transfer from provider to merchant.
is_payrailsBOOLEANWhether the payment was processed by Payrails.
payrails_payment_idVARCHARUnique identifier of the Payment in Payrails.
payrails_execution_idVARCHARUnique identifier of the execution.
metaVARIANTFull merchant's meta field details.