Trade orders record all payment and billing activities in Subotiz. They include subscription activations, renewals, usage-based charges, and one-time purchases. Each Trade order matches a merchant order, ensuring the customer’s payment results stay consistent with the merchant’s system.
Trade orders give merchants clear visibility into refund operations, billing exceptions, and disputes. They are one of the core data entities in the Subotiz billing system.
Role in the Billing System
Subotiz creates a Trade order whenever a payment action occurs or when a payment method is validated. Each Trade order stores key information such as order type, payment method, amount, customer details, country of origin, and failure reasons.
Trade orders are used to:
- Reflect merchant order status in real time
- Provide the source of truth for invoices, refunds, and disputes
- Support accurate reconciliation with complete and traceable billing records
- Record the full timeline of payment and refund events
Trigger Events for Trade Orders
The system generates a Trade order in the following situations:
- A new subscription is activated
- A subscription renews automatically
- A one-time product is purchased
- A trial plan requires a stored payment method (including zero-amount authorization)
- A usage-based charge is generated
- A payment method is validated
- A payment is created through OpenAPI
Order Types and Related Records
- Trade order: The main billing record linked to merchant orders. Statuses include Pending, Under review, Paid, Partially refunded, and Refunded.
- Refund order: Tracks refund requests and their outcomes.
- Dispute order: Records chargeback or dispute cases throughout the resolution process.
Refunds
All refunds originate from a Trade order. This ensures each refund is tied to the correct transaction and processed through the appropriate payment channel. When a refund is created, Subotiz generates a Refund order and tracks the result. Once the refund succeeds, the Trade order and related invoice update accordingly.
Trade Order Fields
Each Trade order includes the following fields:
- Trade order ID: Unique identifier in Subotiz
- External order ID: Merchant’s order reference
- Order type: Subscription activation, renewal, one-time purchase, usage-based charge
- Payment method: Credit card, PayPal, or supported alternatives
- Customer: Buyer’s identifier
- Amount and currency: Billed amount
- Created at: Timestamp of order creation
- Status: Pending, Under review, Paid, Partially refunded, Refunded
Viewing Trade Orders in the Admin
Go to Transaction > Trade orders in the Subotiz admin to view all billing records. The list displays Trade order ID, external order ID, customer, order type, payment method, creation time, status, and amount.
From this page, you can:
- Search by Trade order ID or external order ID
- Filter by order type, payment status, or payment method
- Apply a date range using the calendar selector
- Open a Trade order to view full transaction details and refund history
Trade orders centralize billing records in Subotiz. They connect payments, refunds, and disputes, giving merchants a clear and reliable view of their entire billing process.