How to Upload Transactions Manually

Last updated February 28, 2026

If you process sales through a platform that doesn't have a direct Oshi integration, you can upload transactions manually using a CSV file. This lets you reward customers with Bitcoin on any purchase, regardless of your point-of-sale system.

Uploaded transactions appear in the Unpaid tab, where you can review them before processing payouts.

Before You Start

Prepare a CSV file with the following columns:

Column Required Format Example
Email Yes Valid email address customer@example.com
Amount Yes Purchase amount in cents (whole number) 4999 (= $49.99)
Order ID Yes Unique order identifier ORD-12345
Date Yes ISO 8601 datetime 2025-01-15T14:30:00Z
Important: The amount should be in cents, not dollars. A $49.99 purchase is entered as 4999.

Steps

Step 1: Open the Upload Tab

  1. From your Oshi dashboard, click Transactions in the left sidebar
  2. Select the Upload tab

Step 2: Upload Your CSV

  1. Click Upload CSV or drag and drop your file
  2. The file must be a CSV, with a maximum size of 10MB

Step 3: Map Your Columns

After uploading, the dashboard shows a preview of your data. Map each column in your CSV to the required fields:

  1. Email — The column containing customer email addresses
  2. Amount — The column containing purchase amounts (in cents)
  3. Order ID — The column containing order identifiers
  4. Date — The column containing transaction dates

Step 4: Select Currency

Choose the currency for the purchase amounts:

  • USD — US Dollars
  • CAD — Canadian Dollars
  • MXN — Mexican Pesos

Step 5: Review and Submit

  1. Review the mapped data in the preview table
  2. Verify the amounts and dates look correct
  3. Click Submit to create the transactions

After submitting, you'll be redirected to the Unpaid tab where your uploaded transactions appear and are ready for processing.

What's Next

Was this article helpful?