Guides
Managing Orders

Managing Orders

Learn how to track, cancel, and manage your orders on Brtr.

Viewing Your Orders

Profile Page

Access your orders at app.brtr.world/profile (opens in a new tab):

Orders are organized by status:

  • Active — Open orders waiting to be filled
  • Pending — Orders with in-progress fills
  • Completed — Successfully filled orders
  • Cancelled — Orders you've cancelled

Order Details

Click any order to see:

  • Full order information
  • Payment options
  • Fill history
  • Current state

Order States

Open

Order is live and accepting fills.

You can:

  • Cancel the order
  • Share the order
  • Wait for fills

You cannot:

  • Edit the order
  • Partially fill (full fills only)

Cancelling Orders

You can cancel orders that are in the Open state:

  1. Go to your Profile
  2. Find the order you want to cancel
  3. Click "Cancel Order"
  4. Confirm the transaction

Cancellation Rules

  • ✓ Can cancel: Open orders
  • ✗ Cannot cancel: AwaitingConfirmation, AwaitingFinalization
  • ✗ Cannot cancel: Completed, Cancelled (already closed)

Cancelling returns 100% of your deposited tokens. There are no cancellation fees.

Tracking Cross-Chain Fills

For cross-chain trades, you can monitor progress:

Status Timeline

StageWhat's Happening
Fill InitiatedBuyer tokens escrowed on buyer chain
Message SentFILL_INITIATE traveling via LayerZero
Tokens LockedYour seller tokens are locked
Confirmation SentFILL_CONFIRMATION traveling to buyer
Tokens ReleasedBuyer tokens released to you
Finalization SentFILL_FINALIZATION traveling to you
CompleteYour tokens released to buyer

Checking Message Status

Use LayerZero Scan (opens in a new tab) to verify message delivery:

  1. Find your transaction hash
  2. Search on LayerZero Scan
  3. See message status and timing

Recovery Functions

If a cross-chain trade gets stuck (very rare), recovery options are available after 30 minutes:

For Sellers

Emergency Finalize (Admin only)

  • Use if buyer paid but finalization never arrived
  • Admin verifies trade and completes manually

Emergency Refund (Admin only)

  • Use if trade failed and needs cleanup
  • Returns tokens to seller

For Buyers

Refund Pending Fill

  • Available after 30-minute timeout
  • Returns escrowed tokens if confirmation never arrived
  • Safe because seller tokens haven't been sent yet
⚠️

Recovery functions exist for edge cases. In normal operation, trades complete automatically. If you think you need recovery, contact support first.

Order History

Export History

Your complete trading history is available on the Profile page:

  • All orders created
  • All orders filled
  • Timestamps and amounts
  • Transaction hashes

On-Chain Verification

All orders are stored on-chain and can be verified via block explorer:

  • Order creation events
  • Fill events
  • State change events
  • Fee collection events

Best Practices

Monitor Active Orders

  • Check your profile regularly
  • Enable notifications (coming soon)
  • Cancel stale orders if no longer wanted

Keep Records

  • Note transaction hashes
  • Track your trades for tax purposes
  • Export history periodically

Troubleshooting

If an order seems stuck:

  1. Check if transaction confirmed
  2. Verify order state in contract
  3. For cross-chain, check LayerZero Scan
  4. Wait for timeout if recovery needed
  5. Contact support if issues persist