type field.
- Unified financial movements: All payments, refunds, credit notes, fees, chargebacks, and payouts in a single model
- Type-based filtering: Query by transaction type to get specific financial movements
- Complete audit trail: Full relationship tracking to invoices, orders, subscriptions, and original transactions
- Gateway integration: Detailed payment gateway information and transaction IDs
Attributes
Transactions Attributes
| Property | Type | Description |
|---|---|---|
rootfi_id | integer | Unique identifier for this transaction |
rootfi_created_at | string | When this transaction was created in Commenda’s system (ISO 8601) |
rootfi_updated_at | string | When this transaction was last updated (ISO 8601) |
rootfi_integration_type | enum | |
platform_id | string | Platform-specific transaction identifier |
type | enum | Type of transaction (PAYMENT, REFUND, CREDIT_NOTE, etc.) |
invoice_id | string | Reference to the associated Invoice |
order_id | string | Reference to the associated Order (if applicable) |
subscription_id | string | Reference to the associated Subscription (for recurring payments) |
contact_id | string | Reference to the Contact |
currency_id | enum | ISO 4217 currency code |
amount | double | Transaction amount (always positive; type indicates direction) |
status | enum | Current status of the transaction |
payment_method_type | enum | Payment method used (for payments) |
gateway | string | Payment gateway/processor name (e.g., “stripe”, “razorpay”) |
gateway_transaction_id | string | Platform-specific transaction ID from the gateway |
original_transaction_id | string | For refunds/reversals, reference to the original payment |
reference_number | string | Human-readable reference number |
description | string | Human-readable description of the transaction |
reason | enum | Standardized reason code (primarily for refunds/credit notes) |
reason_code | string | Platform-specific reason code |
metadata | object | Additional platform-specific data |
created_at | string | Original transaction timestamp from platform (ISO 8601) |
updated_at | string | Last update timestamp from platform (ISO 8601) |
Type Enum Values
| Value | Description |
|---|---|
PAYMENT | Contact payment received |
REFUND | Money returned to contact |
CREDIT_NOTE | Credit applied to contact account |
FEE | Processing fee or platform charge |
CHARGEBACK | Payment disputed and reversed by contact’s bank |
PAYOUT | Transfer to merchant/vendor account |
ADJUSTMENT | Manual adjustment to balance |
Status Enum Values
| Value | Description |
|---|---|
REQUIRES_ACTION | Transaction requires additional action before it can be completed |
PENDING | Transaction is being processed |
AUTHORIZED | Transaction has been authorized but not yet captured |
PAID | Transaction payment was successfully captured |
FAILED | Transaction failed to process |
CANCELED | Transaction was canceled before completion |
REFUNDED | Transaction funds were returned or credited back |
UNKNOWN | Status cannot be determined |
REVERSED | Transaction was reversed after completion |
Payment Method Type Enum Values
| Value | Description |
|---|---|
CARD | Credit or debit card payment |
BANK_TRANSFER | Direct bank transfer or ACH |
WIRE_TRANSFER | Wire transfer |
PAYPAL | PayPal payment |
APPLE_PAY | Apple Pay |
GOOGLE_PAY | Google Pay |
CHECK | Check payment |
CASH | Cash payment |
CRYPTO | Cryptocurrency payment |
OTHER | Other payment method |
UNKNOWN | Payment method cannot be determined |
Reason Enum Values
| Value | Description |
|---|---|
CUSTOMER_REQUEST | Contact requested the refund/credit |
DUPLICATE | Duplicate charge |
FRAUD | Fraudulent transaction |
QUALITY_ISSUE | Product or service quality issue |
BILLING_ERROR | Billing mistake |
LOYALTY_DISCOUNT | Loyalty program credit |
PROMOTIONAL | Promotional credit or discount |
ADJUSTMENT | Manual adjustment |
OTHER | Other reason |