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 |
|---|---|---|---|
| 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
- From your Oshi dashboard, click Transactions in the left sidebar
- Select the Upload tab
Step 2: Upload Your CSV
- Click Upload CSV or drag and drop your file
- 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:
- Email — The column containing customer email addresses
- Amount — The column containing purchase amounts (in cents)
- Order ID — The column containing order identifiers
- 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
- Review the mapped data in the preview table
- Verify the amounts and dates look correct
- 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
- Understanding your reward activity — Learn how to read the full Reward Activity table.
- How to resolve an unpaid rewards balance — Process unpaid transactions and fund rewards.
- How to fund your rewards balance — Ensure your account has enough sats to cover rewards.
Related Articles
How to Create and Manage CampaignsUnderstanding Reward ClawbacksHow to Filter and Search TransactionsUnderstanding Transaction StatusesUnderstanding Your Reward ActivityHow to Manage Your Rewards SettingsHow to Configure the Rewards Lock-Up PeriodHow to Set Up Ways to RedeemHow to Set Up Referral RewardsHow to Set Up VIP TiersHow to Set Up Social Engagement RewardsHow to Set Up Purchase Rewards
Was this article helpful?