Why Do We Need the Merchant Role?
While Enterprise wallets provide direct blockchain access and are ideal for businesses that want full custody of digital assets, the Merchant role introduces greater flexibility in payment handling.
Merchant wallets allow customers to choose the payment currency, regardless of the wallet’s base denomination. The system automatically converts the incoming crypto into the wallet's currency and credits it to the merchant's balance.
✅ Example:
A merchant wallet is denominated in USDT, but the customer pays in TRX. The system performs the conversion and credits the USDT equivalent to the merchant wallet, removing any manual intervention.
This role is particularly useful for businesses that:
- Want to offer customers a broad range of crypto payment options
- Prefer to settle in a single fiat or stablecoin
- Need auto-conversion and simplified compliance
Deposit Status Behavior – Key Distinctions
Enterprise Wallet Deposits
- The status always remains “Created”, regardless of whether a deposit was made or not.
- Requested amounts or limits are not supported in enterprise wallets.
- Enterprise wallets are directly linked to blockchain addresses; deposits are monitored via blockchain activity.
Merchant Wallet Invoices – Status Lifecycle
Merchant wallets allow smart invoice generation with limits, expiry windows, and automated status updates. Below is a full breakdown of possible invoice statuses:
| Status | Triggered When... | Details |
|---|---|---|
| 🟡 Unresolved | - Payment was over or under the requested limit (outside delta range) - Invoice was paid after the expiry time - Invoice expired with no payment received | Requires client review. Triggered events will notify clients for manual investigation. |
| 📄 Invoice | - No transaction received - Payment is less than the required amount | Remains in this state until resolved or canceled. |
| ✅ Paid | - Full required amount received - Within valid time range | Automatically updated. Clients can also manually mark as Paid if conditions are matched. |
| ❌ Canceled | - Time limit passed - No payment made or incomplete payment | Must be set manually by the client. Used to finalize unresolved or expired invoices. |
Comments
0 commentsArticle is closed for comments.