Skip to main content

Understanding Your Wallet

Your wallet is the financial hub of your Cajas account. It tracks your balance, deposits, withdrawals, and all transactions.

Wallet Overview

Access your wallet at /wallet or click the + button next to your balance in the navbar.

Current Balance

Your available funds in ARS (Argentine Pesos).Visible in:
  • Navbar (desktop)
  • Wallet page header
  • Profile dropdown

Transaction History

Complete record of:
  • Deposits
  • Withdrawals
  • Case openings
  • Item sales

Payment Methods

Supported methods:
  • Mercado Pago (ARS)
  • Binance Pay (Crypto)

Minimum Amounts

  • Deposit: $7,000 ARS minimum
  • Withdrawal: $1,000 ARS minimum
  • Bonus: 10% on deposits ≥ $10,000

Wallet Page Interface

The wallet page (/app/wallet/page.tsx) features a sidebar navigation with four tabs:
View your current balance and account summary.Empty State:
  • Displays gaucho mascot image
  • Message: “Sin saldo disponible”
  • Prompt to make a deposit

Depositing Funds

Add balance to your account to start opening cases.
1

Navigate to Deposit Tab

  1. Go to /wallet
  2. Click “Depositar” in the sidebar
The deposit form loads with default values.
2

Select Currency

Click the currency dropdown (shows ARS flag by default).Currently supported:
  • ARS (Argentine Peso) - Primary currency
Future currencies may include USD, EUR, and various cryptocurrencies.
3

Choose Payment Method

Two payment methods are available:

Mercado Pago

  • Most popular for ARS deposits
  • Instant processing
  • Supports debit/credit cards
  • Bank transfers
  • Mercado Pago balance

Binance Pay

  • For cryptocurrency deposits
  • Supports multiple crypto assets
  • Converted to ARS at current rate
  • Lower fees for large amounts
Click your preferred method. A blue indicator appears when selected.
4

Enter CUIT/CUIL

Required for compliance:Campo: Número de CUIT/CUIL (marked with red asterisk)Format: 20-12345678-9This is your tax identification number used for:
  • Payment verification
  • Regulatory compliance
  • Withdrawal processing
5

Set Deposit Amount

Two ways to enter amount:

Manual Input

Type the amount in the input field (font-mono, bold for clarity).

Quick Presets

Click one of the preset buttons:
  • $7,000 (minimum)
  • $15,000
  • $150,000
  • $1,500,000
Selected preset highlights in yellow with a glow effect.
6

Review Bonus

The yellow banner shows:“Obtén un bono adicional de 10% con un depósito mínimo de $10.000”If your amount is ≥ $10,000, you’ll receive:
  • 10% extra balance
  • Example: Deposit 10,000Receive10,000 → Receive 11,000
7

Submit Deposit

Click “Depositar” button at the bottom.The system:
  1. Validates the amount (≥ $7,000)
  2. Validates CUIT/CUIL format
  3. Generates payment request
  4. Redirects to payment gateway
8

Complete Payment

At the payment gateway:Mercado Pago:
  • Choose payment method
  • Enter card/bank details
  • Confirm payment
  • Redirected back to Cajas
Binance Pay:
  • Scan QR code
  • Confirm in Binance app
  • Payment processes
  • Redirected back to Cajas
9

Confirmation

After successful payment:
  • Balance updates immediately
  • Transaction appears in history
  • Bonus (if applicable) is added
  • Success notification displays
You can now use your balance to open cases!
Important Deposit Rules:
  1. Transfer amount must EXACTLY match the deposit amount
  2. Each payment ID can only be used once
  3. Payments typically process within 5-10 minutes
  4. If payment fails, funds are not deducted
See the info box at the bottom of the deposit form for details.

Withdrawing Funds

Cash out your balance to your bank account or payment method.
1

Navigate to Withdraw Tab

  1. Go to /wallet
  2. Click “Retirar” in the sidebar
The withdrawal form loads with your current balance.
2

Check Minimum Balance

The minimum withdrawal is displayed in a red badge:“Mín: 1,000.00 ARS”If your balance is below this, you cannot withdraw.
3

Select Withdrawal Method

Click the method dropdown to select your withdrawal destination.Available withdrawal method:
  • AstroPay - Withdraw to your AstroPay account
Withdrawal methods are based on your deposit method and account verification status. AstroPay is currently configured as the primary withdrawal option in the interface.
4

Enter Withdrawal Amount

Two ways to set amount:

Manual Input

Type the amount in the input field.

Percentage Buttons

Quick shortcuts:
  • Mín - Minimum amount ($1,000)
  • 25% - Quarter of balance
  • 50% - Half of balance
  • Máx - Full balance
These buttons calculate based on your current balance.
5

Submit Withdrawal Request

Click “Solicitar Retiro” (Request Withdrawal) button.The system:
  1. Verifies amount ≥ minimum
  2. Verifies amount ≤ available balance
  3. Checks account verification
  4. Creates withdrawal request
6

Processing

Withdrawal requests typically:
  • Instant to 24 hours - Crypto withdrawals
  • 1-3 business days - Bank transfers
  • 3-5 business days - International transfers
You’ll receive:
  • Email confirmation
  • Transaction ID
  • Expected completion date
7

Completion

Once processed:
  • Funds arrive in your account
  • Transaction marked as “completed”
  • Balance reflects the deduction
Withdrawal Restrictions:
  • Account must be verified (ID + address)
  • CUIT/CUIL must be provided
  • Cannot withdraw bonus funds until wagered
  • Withdrawals may be audited for compliance
If your withdrawal is delayed, check your email for requests for additional information.

Transaction History

Every action that affects your balance is recorded.

Transaction Types

The transactions table tracks four types:
Type: depositRecorded when:
  • You complete a payment
  • Funds are added to balance
  • Bonuses are applied
Fields:
  • Amount (positive)
  • Payment method
  • Reference ID (payment gateway ID)
  • Timestamp

Viewing History

The history tab will display transactions in a table format:
Table Columns
layout
  • Type - Icon indicating transaction type
  • Description - Human-readable description
  • Amount - Formatted currency (green for + / red for -)
  • Date - Relative time (e.g., “2 hours ago”)
  • Status - Badge showing current status
  • Actions - View details, receipt, support

Filtering History

Customize your transaction view:

By Type

  • All Transactions
  • Deposits Only
  • Withdrawals Only
  • Case Opens
  • Item Sales

By Date

  • Last 24 Hours
  • Last 7 Days
  • Last 30 Days
  • Last Year
  • All Time
  • Custom Range

By Amount

  • All Amounts
  • Above $X
  • Below $X
  • Range (XX - Y)

Exporting History

Download your transaction history:
1

Click Export

On the history tab, click the “Exportar” button in the top-right.
2

Choose Format

Select export format:
  • CSV - For spreadsheets
  • PDF - For records/printing
  • JSON - For developers
3

Download

The file downloads with filename:cajas-transactions-{start-date}-{end-date}.{format}

Balance Display

Your balance is shown in multiple locations:
[Argentina Flag Icon] $XX,XXX.XX  [+ Button]
  • Updates in real-time
  • Currency formatted with thousands separators
  • + Button opens wallet deposit tab
  • Green glow effect on the add button

Mobile Dropdown

On mobile, balance appears in the profile dropdown:
  • Wallet icon
  • “Balance” label
  • Amount displayed
  • Tap to navigate to /wallet

Wallet Page Header

Large, prominent display:
  • Bold typography
  • Currency icon
  • Exact amount with cents
  • Last updated timestamp

Payment Security

Secure Gateways

All payments processed through:
  • PCI-DSS compliant providers
  • Encrypted connections (HTTPS)
  • Secure tokenization
  • No card data stored

Identity Verification

Required for withdrawals:
  • Government-issued ID
  • Proof of address
  • CUIT/CUIL validation
  • Phone verification

Transaction Monitoring

Automated fraud detection:
  • Unusual patterns flagged
  • Large transactions reviewed
  • Duplicate prevention
  • Chargeback protection

Regulatory Compliance

Following all local laws:
  • AML (Anti-Money Laundering)
  • KYC (Know Your Customer)
  • Tax reporting (when required)
  • Consumer protection

Database Structure

For developers, here’s the wallet data model:

Users Balance

CREATE TABLE users (
  id UUID PRIMARY KEY,
  username TEXT,
  balance NUMERIC DEFAULT 0,
  created_at TIMESTAMP
);

Transactions Table

CREATE TABLE transactions (
  id UUID PRIMARY KEY,
  user_id UUID REFERENCES users,
  amount NUMERIC NOT NULL,
  type TEXT NOT NULL,  -- deposit, withdraw, case_open, item_sell
  reference_id UUID,   -- links to related record
  created_at TIMESTAMP DEFAULT NOW()
);

Key Queries

Get Balance:
SELECT balance FROM users WHERE id = $1;
Add Funds:
UPDATE users SET balance = balance + $1 WHERE id = $2;
INSERT INTO transactions (user_id, amount, type) VALUES ($2, $1, 'deposit');
Deduct Funds:
UPDATE users SET balance = balance - $1 WHERE id = $2;
INSERT INTO transactions (user_id, amount, type) VALUES ($2, -$1, 'case_open');
Transaction History:
SELECT * FROM transactions
WHERE user_id = $1
ORDER BY created_at DESC
LIMIT 50;

Troubleshooting

Possible causes:
  • Payment still processing (wait 10 minutes)
  • Payment failed at gateway
  • Network error during callback
Solution:
  1. Check your email for payment confirmation
  2. Check payment method (Mercado Pago/bank) for charge
  3. Refresh the wallet page
  4. Contact support with payment reference ID
Possible causes:
  • Balance below minimum ($1,000)
  • Account not verified
  • Active wagering requirements
  • Technical issue
Solution:
  1. Verify your balance is sufficient
  2. Complete account verification in profile
  3. Check for wagering requirements (bonus terms)
  4. Try again in a few minutes
Possible causes:
  • Browser cache
  • Session sync issue
  • Database lag
Solution:
  1. Hard refresh the page (Ctrl+Shift+R)
  2. Log out and log back in
  3. Clear browser cache
  4. Check transaction history for accuracy
Common errors:
  • “Amount mismatch”
  • “Payment ID already used”
  • “Gateway timeout”
Solution:
  1. Return to deposit form
  2. Generate new payment request
  3. Use exact amount shown
  4. Complete within time limit (usually 30 minutes)

Best Practices

Budget Wisely

  • Set a deposit limit
  • Track your spending
  • Don’t chase losses
  • Withdraw winnings regularly

Verify Before Large Deposits

  • Complete account verification
  • Test with small deposit first
  • Save payment confirmations
  • Keep receipts for taxes

Monitor Transactions

  • Check history weekly
  • Report any discrepancies
  • Save export for records
  • Track profit/loss

Secure Your Account

  • Use strong password
  • Enable 2FA (when available)
  • Don’t share credentials
  • Log out on shared devices
Pro Tip: Deposit slightly more than you plan to spend to account for the 10% bonus threshold. For example, deposit 11,000toget11,000 to get 12,100 total (including bonus), giving you more value than depositing $10,000 twice separately.

Build docs developers (and LLMs) love