company logo

Help Center

Go to Aesthetix CRM
Terms & ConditionsPrivacy Policy
All collectionsPaymentsOrders, Subscriptions and TransactionsImport and Export Transactions, Orders, and Subscriptions (CSV)

Import and Export Transactions, Orders, and Subscriptions (CSV)

Export transactions, orders, and subscriptions to CSV from Aesthetix CRM, understand the multi-row column format, and import historical payment data using CSV files.

Aesthetix CRM lets you export your payment data to CSV for reporting, reconciliation, accounting, and compliance, and import historical transactions and orders from other platforms so your revenue history stays complete. This guide covers exporting transactions, orders, and subscriptions, how to read the CSV format, and how to import transactions and orders using CSV files.

Export Transactions

  1. Go to Payments → Transactions.

  1. Open the Transactions tab to view all payment transaction records.

  1. Apply any filters or a search if needed (for example, date range, payment status, or source type).

  2. Click the export (Download) button. A secure download link is emailed to the logged-in user.

Security note: The email link is valid for 7 days and is unique to the requesting user. If it expires, simply generate a new export.

Export Orders

  1. Go to Payments → Orders.

  1. Open Orders to view and manage all orders.

  1. Optionally apply filters such as order status, date range, source type (Funnel, Payment Link, Store Checkout), or product type (one-time vs. recurring).

  2. Click the export button to download all orders as a CSV file. A secure download link is emailed to you and expires after 7 days.

Interactive walkthrough

Export Subscriptions

  1. Go to Payments → Subscriptions.

  1. Open the Subscriptions tab to manage recurring billing.

  1. Optionally apply a search or filters such as status (Active, Canceled, Past Due), product type, customer details, provider, currency, or date range.

  2. Click the export button to download all subscriptions as a CSV file. The secure download link is emailed to you and expires after 7 days.

How the CSV Format Works

Exports are delivered as a link via email (not downloaded directly in-app) and can be opened in any spreadsheet tool. Before you analyze the data, it is important to understand that one row does not always equal one transaction, order, or subscription.

A single record can spread across multiple rows because it may include multiple:

  • Products: Each product creates its own line row.

  • Taxes: Each unique tax name per product creates a row.

  • Miscellaneous charges: Processing charges, late fees, and tips are broken out.

This ensures every financial component is separately identifiable for accounting-grade reporting. When a record spans multiple rows, not all columns are populated on every row. Product-specific and tax-specific data appears on its own row, and full record data appears on one row per transaction, order, or subscription.

Grouping Multi-Row Records

To summarize totals correctly in Sheets or Excel, group values by the record's ID (Internal transaction id, Internal order id, or Subscription id) so you do not double-count.

Example: An order with 3 products and 2 exclusive taxes could generate 6 rows: 2 rows per product and additional rows where each tax amount for each product is its own row. All rows share the same order ID. When some products have inclusive taxes and others have none, the row count changes accordingly, and the tax columns are blank on rows with no tax.

Data Consistency Rules

These exports are built for reconciliation, accounting, and BI workflows with stable, predictable formatting:

  • 0 vs. blank: A 0 appears only when the field applies and the value is truly zero. A blank appears only when the field does not apply to that row (for example, a payment method on an unpaid order, or trial fields when no trial exists).

  • Stable structure: Column ordering is consistent to support pivots, imports, and BI pipelines.

  • Tax rate precision: Tax rate percentages export with 4 decimal places (for example, 7.1250%) to support fractional rates. Tax amounts remain rounded to 2 decimals based on currency standards.

  • Combined payments: When a patient pays with more than one method (for example, card plus gift card), each is shown distinctly in the value columns.

Transactions CSV Column Reference

Column name

Description

Example

Internal transaction id

Unique transaction identifier inside Aesthetix CRM

69369a9968f735180bfeb6ed

Location id

Your account identifier

NyGCsdhgRZ8Ffa8Ssagfhd

Customer id

Customer identifier

jbtyjkzMjvd8cLi9HUC

Customer name

Display name from transaction

Alex Ray

Customer email

Email used for receipt delivery

[email protected]

Customer phone

Phone number used at checkout

+1 555-012-2345

Payment method

Method used for payment

Credit Card, Cash, Instant Transfer

Currency

Currency of transaction

USD

Sub total

Product total before discounts and exclusive taxes

100.00

Discount

Total discounts applied on the subtotal

-15.00

Total tax amount (excluded in prices)

Tax added on top of subtotal after subtracting discounts

8.40

Total tax amount (included in prices)

Tax included within product prices (already part of the subtotal)

0.00

Tip amount

Tip added voluntarily; not included in the amount due

5.00

Late fees

Late fee added beyond product price

10.00

Total amount due

Original total for the order/invoice (subtotal, discount, taxes, late fees); does not consider partial payments and always shows the initial amount due

103.40

Total amount paid

Actual amount paid in this transaction (amount due plus any tips and processing charges)

110.40

Coupon code

Applied coupon, if any

WELCOME15

Status

Status of transaction

Success, Refunded

Live mode

Whether it occurred in Live mode or Test mode

Yes

Source type

Checkout where purchase occurred

Invoice, Funnel Page, Form

Source id

Internal ID of the source entity

inv_8281

Source name

Display name of source as defined by your practice

Q4 Billing Invoice

Internal order id

Order reference (if applicable)

jfnkwbgfwbegiu234

Payment provider

The gateway used for the transaction

Stripe, NMI, Authorize.net

Subscription id

Subscription reference (if applicable)

sub_7A91F

Charge id

Provider charge identifier

ch_1NHXYZ

Connected account

Connected payment provider merchant/client account id

acct_1sagewg732Hko

Transaction date

Date of charge

Dec 8, 2025

Transaction time

Time of charge

03:00 PM

Timezone

Timezone of record

America/New_York

Is refunded

Refund status reference; NA if not refunded

Yes/No

Amount refunded

Total refunded amount (sums all refunds)

25.00

Refund date

Date of refund (last refund date if multiple)

Dec 9, 2025

Line item name

Product name

Membership Plan

Line item quantity

Quantity purchased

1

Line item price

Price per line item

100.00

Line item coupon discount

Coupon portion for the product

15.00

Line item subtotal

Subtotal specific to the product

85.00

Line item product id

Product identifier

prod_5449

Tax name

Unique tax label (shown once per transaction)

Sales Tax

Tax amount

Tax value for this tax line (summed across products with this tax name)

8.40

Processing charge name

Name of misc fee (maximum 1 per transaction; blank if none)

Platform Fee

Processing charge amount

Misc fee amount; blank if none

2.00

Gift card order number

If a gift card was used; blank if not

GC-ORD-19202

Gift card amount used

Amount redeemed using the gift card; blank if not used

20.00

Orders CSV Column Reference

Column name

Description

Example

Internal order id

Internal identifier for the order

69369a9968f735180bfeb6ed

Location id

Your account identifier

NyGCsdhgRZ8Ffa8Ssagfhd

Customer id

ID of the customer who placed the order

jbtyjkzMjvd8cLi9HUC

Customer name

Customer display name

Jordan Lane

Customer email

Email collected via checkout

[email protected]

Customer phone

Phone collected via checkout

+44 7700 900111

Payment method

Method collected during checkout; blank if unpaid

Credit Card, Cash, Instant Transfer

Currency

Currency of product pricing

USD

Sub total

Value of items before discount and exclusive taxes

120.00

Discount

Discounts applied to the order

-20.00

Total tax amount (excluded in prices)

Tax added on top of subtotal

8.40

Total tax amount (included in prices)

Tax already part of item prices

0.00

Total amount

Total payable after discounts, taxes, and misc charges

108.40

Coupon code

Code used at checkout (if any)

SPRING20

Status

Order's payment status

Completed, Pending

Live mode

Confirms Test vs. Live environment

Yes, No

Total products

Total number of products in the order

3

One-time products

Number of one-time products

2

Recurring products

Number of subscription products

1

Source type

Entry point where order was created

Store Checkout, Form, Funnel

Source id

Internal ID of the source

afalfgn4ag12neogho

Source name

Display name of the source

Gift Card Store

Order date

Date the order was finalized

Dec 10, 2025

Order time

Time the order was finalized

10:45 AM

Timezone

Timezone of the order record

America/Chicago

Line item name

Product name

Premium Coaching Plan

Line item quantity

Quantity purchased

1

Line item price

Price per unit

100.00

Line item discount

Discount allocated to this line

20.00

Line item subtotal

Subtotal for the product line

80.00

Line item product id

System identifier for product

prod_52ZS

Line item price id

Identifier for price or variant

price_00382

Tax name

Tax type applied

Sales Tax

Tax amount

Amount of tax for this line

5.60

Address line 1

Shipping/billing street (if captured)

123 Main St

City

City

Austin

State

State/Region

TX

Country

Country

US

Postal code

Zip or postal code

73301

Processing charge name

Any miscellaneous charge name

Handling Fee

Processing charge amount

Value of misc charge

2.80

Subscriptions CSV Column Reference

Column name

Description

Example

Subscription id

Internal system ID of subscription

jfhbiabfoanfle13kj

Location id

Your account identifier

NyGCsdhgRZ8Ffa8Ssagfhd

Customer id

System identifier for customer

jbtyjkzMjvd8cLi9HUC

Customer name

Customer display name

Maria Russell

Customer email

Email stored for subscriber

[email protected]

Customer phone

Phone stored for subscriber

+1 480-555-7002

Subscription start

Date subscription was created

Jan 05, 2026

Subscription end

End date if canceled or expired; blank if not ended

May 30, 2026

Number of trial days

Applied trial length; blank if no trial

14

Trial start

First day of trial; blank if no trial

Jan 05, 2026

Trial end

Trial completion date; blank if no trial

Jan 19, 2026

Cancelled at

Timestamp subscription was canceled; blank if not

Mar 15, 2026

Payment method

Method used for latest successful charge

Visa •1234

Currency

Subscription currency

USD

Sub total

Total before discount and exclusive tax (excludes setup fees)

200.00

Discount

Discount applied (coupon, etc.)

-20.00

Total tax amount (excluded in prices)

Taxes applied on top (excludes setup fees)

14.40

Total tax amount (included in prices)

Taxes baked into price (excludes setup fees)

0.00

Total amount

Final charge value (after discount and taxes; excludes processing charges)

194.40

Coupon code

Coupon applied (if any)

WELCOME10

Status

Subscription lifecycle state

Active, Past Due, Cancelled

Live mode

Whether subscription is test or live

Yes, No

Source type

Checkout origin

Funnel, Payment Link, Store

Source sub type

More specific source classification

One-Step Checkout

Source id

Internal identifier of the checkout

fnl_0188

Source name

Display title of source

Membership Funnel

Payment provider

Provider used for billing

Stripe

Connected account

Provider account used for billing

acct_5520XX

Transaction date

Date of last successful renewal

Mar 05, 2026

Transaction time

Time of last charge

2:10 PM

Timezone

System timezone

America/New_York

Total products

Count of products tied to subscription

1

Line item name

Product title

Monthly Membership

Line item quantity

Product quantity

1

Line item price

Price per product unit

200.00

Line item discount

Discount applied to product

20.00

Line item subtotal

Product subtotal (before tax and fees)

180.00

Line item product id

Product reference ID

prod_X7E12

Tax name

Tax label for line

NY Sales Tax

Tax amount

Tax portion allocated to this line

14.40

Last paused on date

Most recent pause timestamp

April 01, 2026

Resumed on date

Actual date the subscription resumed from a paused state

April 10, 2026

Pause end date

Projected end date of the most recent pause

April 10, 2026

Processing charge name

Additional fee name

Platform Fee

Processing charge amount

Value of charge

2.50

Import Transactions and Orders

You can bulk import historical transactions and orders using CSV files. This consolidates financial data from previous platforms into your account, so dashboards and patient timelines reflect an accurate revenue history. Importing can also create or update patient records, uses separate timestamps for when data was ingested vs. the actual transaction time, and includes a preview and validation step before upload.

How to Import Transactions

Importing transactions brings in data that reflects actual payment events, without necessarily creating linked order items.

  1. Go to Payments → Transactions.

  2. Click the Import button.

  3. Download the Sample CSV and make sure your data matches the required format.

  4. Upload your file and review the preview modal for validation.

  5. Confirm the import.

Note: Transactions impact revenue metrics immediately once added.

How to Import Orders

Orders represent itemized sales and automatically generate a linked transaction entry.

  1. Go to Payments → Orders.

  2. Select Import, then upload a properly formatted CSV.

  3. Validate your data in the preview.

  4. Confirm. Each order record auto-creates a transaction and impacts revenue.

Note: Both order and transaction entries reflect on dashboards and reporting.

CSV File Requirements

  • The file must be saved in .csv format.

  • Column headers must exactly match the required field names in the sample file.

  • Each row should represent one transaction. For orders, each line item must be a separate row, with all order-level fields repeated.

  • All required fields must contain valid data.

  • Avoid extra spaces, symbols, or unsupported formatting.

Required Transaction Fields

  • Customer First Name / Last Name: Identifies the patient associated with the transaction.

  • Customer Email: Used for contact identification and communication.

  • Customer Phone: Include the country code for accuracy.

  • Currency: Use standard 3-letter codes (for example, USD, EUR).

  • Amount Paid: Final amount collected from the patient.

  • Transaction Date and Time: When the payment occurred.

  • Payment Method: How the payment was made (for example, card or cash).

  • Payment Provider: The processor used.

  • Address Fields: Billing or location details.

Optional fields such as taxes, discounts, tips, and item details can be included for deeper insights.

Orders Import Column Reference

Column name

Description

Example

Customer First Name

First name of the patient

Jane

Customer Last Name

Last name of the patient

Smith

Customer Email

Patient's email address

[email protected]

Customer Phone

Phone number (include country code if available)

+14155552671

Currency

Currency used (ISO code)

USD

Subtotal

Cost before tax, discount, and shipping

120.00

Discount

Any discount applied

10.00

Total Tax Amount

Total tax charged

8.40

Amount

Final amount paid (Subtotal − Discount + Tax)

118.40

Order Date

Date the order was placed (DD/MM/YYYY)

25/01/2025

Order Time

Time the order was placed (HH:MM)

12:45 AM

Payment Method

Method used (Credit Card, PayPal, Cash, ACH)

Credit Card

Payment Provider

Gateway that facilitated the transaction

Stripe

Line Item Name

Name of the individual item

Skincare Kit

Line Item Quantity

Quantity of the line item

2

Line Item Price

Price per unit, before tax or discount

25.00

Address Line 1

Buyer's street address

123 Main St

City

Buyer's city

San Francisco

State

Buyer's state

CA

Country

Buyer's country (ISO 2-letter or full name)

US

Postal Code

Buyer's postal code

94105

Common Import Errors to Avoid

  • Missing required fields such as Amount Paid, Transaction Date, or Customer Email.

  • Incorrect date or time formats.

  • Using currency symbols instead of ISO codes (use USD, not $).

  • Invalid email or phone number formats.

  • Mismatched or misspelled column headers.

  • Order line items not grouped correctly.

  • Amount mismatch: ensure Amount = Subtotal − Discount + Total Tax Amount.

Tips for Successful Imports

  • Double-check column headers before uploading.

  • Keep formatting consistent across all rows.

  • Validate your data in a spreadsheet tool before exporting to CSV.

  • Test with a small file before importing large datasets.

Frequently Asked Questions

Why does a single transaction or order show multiple rows in the CSV?

Products are tracked per line item and tax details per unique tax name, so each financial component gets its own row. This is standard for accounting-grade reporting. Group by the record's ID to total correctly.

Why does Total Amount Due differ from Total Amount Paid?

Processing charges, tips, and partial payments affect the final amount paid, not the original amount due.

Why don't I see some transactions in my export?

Check that filters are cleared and the correct date range is applied.

Will exports include failed transactions?

Yes, unless you filter to include only Successful or Refunded records.

Does the export include partial refunds?

Yes. The Amount Refunded column reflects the full cumulative refunded amount.

Can I re-export or regenerate a previous file?

Yes. Exports are always generated fresh and can be repeated anytime.

Who can export payment data?

Only users with permission to view and export the relevant records (transactions, orders, or subscriptions).

Can I check subscription billing history from the Orders export?

No. The Orders export shows order-level subscription presence (a count), not billing history. Use the Subscriptions or Transactions export for that.

Will contacts be duplicated when I import?

No. The system matches patients by email or phone before creating a new contact.

Can I backdate an imported transaction?

Yes. You can set the transaction execution date separately from when it is added to your account.

Can I import refunds or voided transactions?

Not at this time. Only successful, completed transactions and orders are supported.

Does importing affect revenue tracking?

Yes. Revenue and financial dashboards update based on your imports.

Did this answer your question?
😞
😐
😁