MintMove API Docs

Subscribe to Notifications

Set up email notifications for order status changes

Overview

MintMove supports email notifications that are automatically sent when important order status changes occur. This provides an additional layer of communication beyond API polling and webhooks.

Note: Email notifications are configured per order using the callback_url parameter during order creation, or you can subscribe to notifications for all orders through your account settings in the dashboard.

When Notifications Trigger

Email notifications are sent for the following events:

  • •Order Created - Confirmation that your order was successfully created with deposit details
  • •Payment Received - Notification when your deposit is detected on the blockchain
  • •Order Completed - Confirmation that the exchange completed and funds were sent to your destination
  • •Order Failed - Alert when an order fails or enters emergency status
  • •Order Expired - Notification if an order expires without receiving payment
  • •Emergency Action Required - Alert when user action is needed to resolve an emergency situation

Email Notification Content

Each notification email includes:

  • • Order ID and current status
  • • Transaction details (amounts, currencies, networks)
  • • Transaction hashes (when available)
  • • Links to view order details in dashboard
  • • Links to blockchain explorers for transaction verification
  • • Action buttons (for emergency situations)

Setting Up Notifications

Method 1: Per-Order (API)

Include a callback URL when creating an order. The email will be sent to the address associated with your API key:

POST /v1/order/create
{
  "from": "BNB",
  "to": "USDT",
  "amount": 1.0,
  "rate_type": "fixed",
  "destination": "0x...",
  "callback_url": "https://your-app.com/webhook"
}

Method 2: Account Settings (Dashboard)

Enable notifications for all orders through your account settings:

  1. Log in to your MintMove account
  2. Go to Dashboard → Settings → Notifications
  3. Enable "Email Notifications"
  4. Select which events you want to be notified about
  5. Save your preferences

How to Unsubscribe

You can unsubscribe from email notifications in several ways:

  • •Via Dashboard: Go to Settings → Notifications and disable email notifications
  • •Via Email: Click the unsubscribe link at the bottom of any notification email
  • •Per-Order: Don't includecallback_url when creating orders (only affects that specific order)

Notification Preferences

You can customize which events trigger notifications:

  • • Order created (always sent if enabled)
  • • Payment received (optional)
  • • Order completed (recommended)
  • • Order failed/expired (recommended)
  • • Emergency action required (always sent if enabled)

Best Practices

  • ✓Use email notifications as a backup to webhooks, not as the primary notification method
  • ✓Enable notifications for critical events (completion, failures, emergencies)
  • ✓Monitor your email spam folder to ensure notifications are being received
  • ✓For high-volume applications, prefer webhooks over email notifications to avoid email overload

Webhooks vs Email

Both webhooks and email notifications serve similar purposes but have different use cases:

Webhooks

  • • Real-time, instant delivery
  • • Programmatic integration
  • • Requires server endpoint
  • • Best for automation

Email

  • • Human-readable format
  • • No server required
  • • May have delivery delays
  • • Best for monitoring