General
Server Side SDKs
Core API
curl --request GET \
--url https://api.rootfi.dev/v4/payments/transactions \
--header 'api_key: <api-key>'{
"data": [
{
"rootfi_id": 8001,
"rootfi_deleted_at": null,
"rootfi_created_at": "2025-01-05T12:00:00Z",
"rootfi_updated_at": "2025-01-05T12:00:00Z",
"rootfi_company_id": 999,
"platform_id": "pay_stripe_001",
"type": "PAYMENT",
"invoice_id": "54321",
"order_id": "ord_001",
"subscription_id": "sub_001",
"contact_id": "12345",
"currency_id": "USD",
"amount": 1075,
"status": "PAID",
"payment_method_type": "CARD",
"gateway": "stripe",
"gateway_transaction_id": "ch_stripe_12345",
"reference_number": "TXN-2025-001",
"description": "Payment for INV-2025-001",
"created_at": "2025-01-05T12:00:00Z",
"updated_at": "2025-01-05T12:00:00Z"
}
],
"prev": "eyJyb290ZmlfaWQiOjQ0MDA2MX0=",
"next": "eyJyb291ZmlfaWQiOjQ0MDA2MX0=",
"total_count": 123
}Get All Transactions
Retrieve all transactions. Use the type parameter to filter by transaction type (e.g., type=PAYMENT to get payment transactions).
curl --request GET \
--url https://api.rootfi.dev/v4/payments/transactions \
--header 'api_key: <api-key>'{
"data": [
{
"rootfi_id": 8001,
"rootfi_deleted_at": null,
"rootfi_created_at": "2025-01-05T12:00:00Z",
"rootfi_updated_at": "2025-01-05T12:00:00Z",
"rootfi_company_id": 999,
"platform_id": "pay_stripe_001",
"type": "PAYMENT",
"invoice_id": "54321",
"order_id": "ord_001",
"subscription_id": "sub_001",
"contact_id": "12345",
"currency_id": "USD",
"amount": 1075,
"status": "PAID",
"payment_method_type": "CARD",
"gateway": "stripe",
"gateway_transaction_id": "ch_stripe_12345",
"reference_number": "TXN-2025-001",
"description": "Payment for INV-2025-001",
"created_at": "2025-01-05T12:00:00Z",
"updated_at": "2025-01-05T12:00:00Z"
}
],
"prev": "eyJyb290ZmlfaWQiOjQ0MDA2MX0=",
"next": "eyJyb291ZmlfaWQiOjQ0MDA2MX0=",
"total_count": 123
}type filter to query specific transaction types.Authorizations
Query Parameters
The number of transactions you want to retrieve
The next page of objects to retrieve
The previous page of objects to retrieve
Comma separated fields to select. Supported values are raw_data, data_hash
Filter by transaction type. Supported values are PAYMENT, REFUND, CREDIT_NOTE, FEE, CHARGEBACK, PAYOUT, ADJUSTMENT. Use type=PAYMENT to retrieve payment transactions (replaces deprecated /payments/payments endpoint).
PAYMENT, REFUND, CREDIT_NOTE, FEE, CHARGEBACK, PAYOUT, ADJUSTMENT Filter by invoice_id to get all transactions for a specific invoice.
Filter by subscription_id to get all transactions for a specific subscription.
Filter by transaction status. Supported values are DRAFT, REQUIRES_ACTION, PENDING, AUTHORIZED, PAID, FAILED, CANCELED, REFUNDED.
DRAFT, REQUIRES_ACTION, PENDING, AUTHORIZED, PAID, FAILED, CANCELED, REFUNDED Filter by payment gateway/processor name (e.g., stripe, razorpay).
Comma separated fields to expand. Supported values are invoice, order, subscription, contact, original_transaction.
Include deleted records. By default, deleted records are not included. Supported values are true and false
Filter by rootfi_updated_at Greater than or Equal To.
Filter by rootfi_company_id. You can filter by any field using this syntax field_name[operator]
Return the count of the objects. Supported values are true and false
Sort by rootfi_created_at
ASC, DESC Sort by rootfi_updated_at
ASC, DESC