Blackcart provides four different types of reports in the Merchant Portal. More details on each report can be found below along with instructions for how to access them and tips for how to reconcile order payments for your accounting.
In this article:
- Types of Reports
- How to access Reports
- Tips for reconciling order payments and payouts
- Metrics Dictionary
Types of Reports
- Orders
- Payments
- Payout Reconciliation
- Payout Summary
Orders Report
The order level report provides a detailed breakdown of each Blackcart order. This report will be updated in real time as the order progresses through the order cycle, allowing you to keep track of order status and any transaction events.
Payments Report
The payments report should be extracted for financial reconciliation purposes. There are several transaction events throughout the Try Before You Buy order cycle and timing for charge and refund transactions will depend on a number of factors. As each order may contain multiple transaction events, the payment level data will include all of them.
Payout Reconciliation Report
The payout reconciliation report shows all of the payments and associated payout IDs from Stripe. The report allows merchants to reconcile bank deposits and see the underlying payment transaction that comprise each payout. The report generated will be emailed to the logged in user. Note that the date range selected filters on the date when the funds are available.
Payout Summary Report
The payout summary report shows a summary of all Stripe payout transfers to your bank account. Note that the date range selected filters on the date when the funds are available.
How to access Reports in the Merchant Portal
- Go to the Reports section in the Merchant Portal
- Select the type of report you want to extract from the drop-down menu
- Select the date range for your export (this can be one or multiple calendar months)
- Click Submit. For the Orders and Payments reports, you will have the option to export the report in a CSV format using the Export Data button. For the Payout Reconciliation and Payout Summary reports, use the Export Data button to email yourself a copy of the report.
Tips for reconciling order payments and payouts
There are a few different ways you can approach reconciling Blackcart orders. We've included two recommended workflows below but the workflow you choose can of course change depending on your preference.
Workflow A
The following reconciliation flow starts with orders, and allows you to validate that all payouts that were expected in your bank account have been received.
Step 1: Start with the Orders report. Define a time period
Step 2: Join the Payments report. When exporting the payments report, extend the range of payments to accommodate the shipping + trial period time between order date and customer payment date.
Step 3: Per order, compare the following:
- Orders report: total sales
- Payments Report: total net payments (payments less refunds)
Step 4: Join the Payout Reconciliation Report for the same time period as the Payments report to get the Stripe Transfer ID.
Step 5: Join the Payout Summary report and validate that all payments were included in a payout.
Workflow B
Starting from Payouts, validate all payments and associated orders that were included in a payout are correct.
Step 1: Start with the Payout Summary report, define a time period
Step 2: Join the Payout Reconciliation report. Extend the beginning range to accommodate the 3-5 day lag between a payment in Stripe and a payout deposit.
Step 3: Join the Payments report to get the Shopify Order Number (this is needed because it is not always added to the Stripe Payments report)
Step 4: Join the Orders report to get order details
Tips when reconciling: The Try Before You Buy order and payment cycle is different than a standard order. A few things to remember when reconciling:
- Orders in Shopify always show as fully paid when the order is initially placed. This means that Shopify payment information is not always correct. You should not expect this to be accurate until the order is in a Completed state. The Orders report will tell you what status each order is in. Orders will also have a Blackcart-Complete tag on them in Shopify once completed.
- Shopify can sometimes contain test orders placed through Blackcart's preview mode. Note that these orders are never fulfilled and you should not expect payment for them. All test orders will be tagged "Blackcart Test" to help you identify them.
- Blackcart reports exported from Stripe sometimes have a lag in reporting payouts from the last 3-5 days.
Reports Metrics Dictionary
| Report Type | Metric | Definition |
| Orders; Payments | Shopify Order ID | The order's position in the shop's count of orders |
| Orders; Payments | Shopify Order Number | Order number displayed in the Shopify Admin |
| Order; Payments | Order Created | Order creation date |
| Orders | Status | Status of the order |
| Orders | Gross Sales | Gross merchandise value transacted |
| Orders | Discounts | Discount value |
| Orders | Returns | Returned gross merchandise value |
| Orders | Net Sales | Gross Sales - Discounts - Returns |
| Orders | Deposit Status | Status indicating whether a deposit was paid on the order |
| Orders | Restocking Fee | Restocking fee charged on the order |
| Orders | Shipping | Shipping fee charged on the order |
| Orders | Tax | Tax charged on the order |
| Orders | Customer Charge | Total amount paid by the customer |
| Orders | Customer Payment Status | Status of customer payment |
| Orders | Service Fee | TBYB fee associated with the order |
| Orders | Transaction Fee | Transaction fee associated with the order |
| Orders | Merchant Payout | Amount of money paid out to the merchant |
| Orders | Sold Item Quantity | Count of all the items sold per order |
| Orders | Return Item Quantity | Count of all the items returned per order |
| Payments | Payment ID | Stripe payment ID |
| Payments | Payment Date | Date of the payment |
| Payments | Type | Payment type |
| Payments | Amount | Total amount paid |
| Payout Reconciliation | id | ID of the automatically created payout associated with this balance transaction |
| Payout Reconciliation | Amount | Total amount of the payment |
| Payout Reconciliation | Created (UTC) | Time at which the balance transaction was created. Dates in UTC |
| Payout Reconciliation | Arrival Date (UTC) | The date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC. |
| Payout Reconciliation | Source Type | Source of the funds |
| Payout Reconciliation | Destination | Two-letter ISO code representing the destination of the funds |
| Payout Reconciliation | Status | Status of the payment |
| Payout Reconciliation | Type | Payment Type |
| Payout Reconciliation | Method | The type of payment method used in the related payment. |
| Payout Reconciliation | Description | An arbitrary string attached to the balance transaction. Often useful for displaying to users. |
| Payout Reconciliation | Balance Transaction | Balance of the transaction |
| Payout Reconciliation | Failure Balance Transaction | Sum of the balanced failed |
| Payout Reconciliation | Failure Message | Failure message |
| Payout Reconciliation | Failure Code | Failure Code |
| Payout Reconciliation | Statement Description | The dynamic statement descriptor or suffix specified when the related charge was created. |
| Payout Reconciliation | Destination Name | Name of the bank account |
| Payout Reconciliation | Destination Country | Two-letter ISO code representing the country of the card. |
| Payout Reconciliation | Destination Last 4 | Last 4 digits of the bank account |
| Payout Reconciliation | Payment Count | The number of transactions associated with the reporting_category. |
| Payout Reconciliation | Payment Gross |
Sum of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Payment Fees |
Sum of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Payment Net |
Sum of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Refund Count | The number of transactions associated with the reporting_category. |
| Payout Reconciliation | Refund Gross |
Refund of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Refund Fees |
Refund of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Refund Net |
Refund of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Collected Fee Count | Total count of collected fees |
| Payout Reconciliation | Collected Fee | Total fee collected from the order |
| Payout Reconciliation | Collected Fee Refund Count | Total count of fees refunded |
| Payout Reconciliation | Collected Fee Refund Gross | Total fee refunded |
| Payout Reconciliation | Adjustment Count | Total number of adjustments |
| Payout Reconciliation | Adjustment Gross | Total adjusted gross amounts |
| Payout Reconciliation | Adjustment Fees | Total adjusted fees |
| Payout Reconciliation | Adjustment Net | Total net fees adjusted |
| Payout Reconciliation | Transfer Count |
Count of total transferred of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Transfer Gross |
Total gross transferred of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Transfer Fees |
Total fees transferred of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Transfer Net |
Sum transferred of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
|
| Payout Reconciliation | Total Count | Total count |
| Payout Reconciliation | Total Gross | Sum of gross fees |
| Payout Reconciliation | Total Fees | Sum of all the fees |
| Payout Reconciliation | Total Net | Sum of all the nets fees |
Comments
0 comments
Article is closed for comments.