Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| company_id | integer | Yes | The rootfi_company_id to associate this transaction with |
| data | array | Yes | Array of transaction objects to create |
| data[].type | string | Yes | Type of transaction (payment, refund, chargeback, adjustment) |
| data[].order_id | string | Yes | Reference to the associated Order |
| data[].contact_id | string | No | Reference to the Contact |
| data[].currency_id | string | Yes | ISO 4217 currency code (e.g., USD, EUR) |
| data[].amount | number | Yes | Transaction amount (always positive, use type to determine direction) |
| data[].status | string | No | Transaction status (pending, completed, failed, cancelled). Defaults to pending |
| data[].payment_method_type | string | No | Payment method used (credit_card, debit_card, bank_transfer, etc.) |
| data[].gateway | string | No | Payment processor or gateway name (e.g., “shopify”, “stripe”) |
| data[].gateway_transaction_id | string | No | Transaction ID from the payment gateway |
| data[].original_transaction_id | string | No | For refunds, reference to the original payment transaction |
| data[].description | string | No | Human-readable description of the transaction |
| data[].reason | string | No | Reason for the transaction (primarily used for refunds) |