How Does
Amedha Work?
A detailed guide explaining every step of the consignment journey — from order creation to financial settlement, and from commission calculation to trading protection.
The Order Journey from Creation to Settlement
Every consignment order goes through defined stages, with automatic safety checks and financial operations at each step.
Order Statuses
Pending Approval
Order created, security and commission frozen, awaiting the receiver's decision.
Approved
Receiver approved the order, their security is frozen and commission is charged.
Settled
Operation completed and final financial settlement between both parties is done.
Upon Rejection, Cancellation, or Expiration
All frozen amounts are returned (creator's security + commission + receiver's security if applicable). No financial loss for either party.
Order Creation Steps
Create Order
The shop selects the metal (gold or silver), weight in grams, and operation type (buy or sell). The order is sent to the linked merchant.
Validation Checks
The order passes through 12 automatic safety checks before creation — from trading status to wallet balance and subscription limits.
Financial Freeze
Security deposit is frozen from the creator's wallet as guarantee, and the due commission is frozen according to settings.
Status Determination
If booking mode is automatic and conditions are met, it's approved instantly. Otherwise, it stays pending until the receiver decides.
Safety Checks (12 Checks)
Verify no manual trading halt is active
Verify price connection and data freshness
Verify creator's wallet status (not suspended, no debt)
Verify receiver's wallet status (not suspended, no debt)
Verify booking mode (automatic/manual/closed)
Verify metal validity and weight
Verify capacity for both parties
Verify subscription limits (daily/weekly/monthly)
Verify receiver has sufficient commission credit
Verify pending order count limit
Verify branch direction lock (prevent arbitrage)
Verify allowed trading hours
Upon Approval
Receiver's security is frozen (if required), commission is charged per the configured timing, and the live market price is updated.
Upon Rejection, Cancellation, or Expiration
All frozen amounts are returned (creator's security + commission + receiver's security if applicable). No financial loss for either party.
Three Modes Control How Orders Are Accepted
Each merchant or supplier can choose how to handle incoming orders — automatic approval, manual review, or temporary closure.
Automatic
Orders are approved instantly without human intervention if they meet the specified conditions.
Instant approval if weight, value, and metal conditions are met
Maximum weight limit can be set per metal
Auto-expires on a set date or when the limit is reached
Orders not meeting conditions automatically switch to manual
Manual
Each order requires explicit approval from the receiver within a set deadline.
Adjustable approval deadline (default: 1 hour)
Receiver reviews details and decides (approve or reject)
Deadline expiry = automatic cancellation and refund
Large orders (above confirmation weight) are forced into this mode
Closed
No new orders are accepted — useful during holidays or maintenance.
Blocks all new order creation for this receiver
Currently approved orders are not affected
Can be activated manually or automatically via schedule
Trading Schedule
Trading hours and closure days can be set per receiver:
Daily opening and closing hours (e.g., 9 AM - 5 PM)
Weekly closure days (e.g., Friday and Saturday)
Custom closure periods per day
Option to accept orders outside hours (disabled by default)
From Global Price to Your Final Price
Prices in Amedha are updated in real-time from global sources, then the merchant's profit margin is added to reach the shop's final price.
Price Calculation Chain
Global Price
Metal price in USD per ounce from live data providers
Convert to Grams
Divide by 31.1035 (grams per troy ounce)
Convert to SAR
Multiply by USD/SAR exchange rate
Merchant Profit
Add merchant's profit margin per settings
Final Price
The price the shop sees when creating an order
Profit Margin Types
No Profit
Base price is used as-is with no addition
Fixed
Fixed SAR amount per gram added to the price
+ profit 5 = 569
Additional Amount
Amount added to or subtracted from the base profit
+ addition 2 = 5
Percentage
Percentage applied to base profit for increase or discount
+ 20% = 12
Real-Time Updates
Prices arrive via WebSocket instantly — no delay, no manual refresh. If the connection drops or prices become stale (>5 seconds), the Price Guard automatically intervenes to protect transactions.
Flexible Commissions with Four Calculation Methods
Commission is the platform fee on each consignment operation. The calculation method, charge timing, and who bears the cost can all be customized.
Commission Calculation Methods
Fixed Amount
Flat fee in SAR per order regardless of value
Every order = 50
Percentage of Value
Percentage of total order value in SAR
Order value 10,000 × 1% = 100
Percentage of Weight
Percentage of (weight × gram price)
50g × 250 × 0.5% = 62.5
Per Gram
Fixed SAR amount multiplied by order weight in grams
50g × 2 = 100
Commission Charge Timing
At Creation
Charged immediately when the order is created — before receiver approval
At Approval
Frozen at creation but actually charged when the receiver approves
At Settlement
Frozen at creation but charged when final settlement is complete
Who Bears the Commission?
Creator Only
The party who created the order bears the full commission
Receiver Only
The party receiving the order bears the full commission
Both Parties
Each party pays their own commission per their configured settings
Subscription Discounts
Entities on higher subscription plans receive commission discounts ranging from 5% to 30% depending on the plan tier.
Commission Calculator
Try calculating the commission yourself — change values and see the result instantly
Amount Before Discount
Final Commission
Bilateral Financial Protection
Security deposit is a financial guarantee frozen from the party's wallet to protect the transaction. The amount is affected by multiple factors and can apply to the creator, receiver, or both.
Bilateral Security
Creator's Security
At order creationFrozen immediately when the order is created from the creator's (shop) wallet as a commitment guarantee.
Receiver's Security
At order approvalFrozen when the receiver (merchant/supplier) approves the order as an execution guarantee.
How Is the Deposit Calculated?
The final amount results from a chain of multipliers applied to the base amount:
Base Amount
Per calculation method (fixed, % of value, % of weight, or per gram)
Plan Discount
5%-30% discount based on entity subscription tier
Partnership Rating
Trusted partnerships reduce the deposit, suspicious ones increase it
Market Volatility
During high volatility, deposits increase to protect both parties
Risk Level
New entities pay higher deposits until they prove reliability
Final Amount
Partnership Rating Impact
Highly Trusted
0.2×
Trusted
0.5×
Neutral
1×
Cautious
1.5×
Untrusted
2×
Insurance Types
Fully Insured
Available balance covers the full required amount. Complete protection for both parties.
Partially Insured
Balance covers only part of the amount. Allowed if the percentage meets the minimum threshold.
Uninsured
Insufficient balance for any deposit. Only allowed if settings permit it.
Enforcement Modes
Always Mandatory
Every consignment operation requires a security deposit regardless of entity history. The default and safest mode.
Hybrid — After Violations
Security is not required until violations accumulate. Once the threshold is reached, security is enforced for 90 days with an escalation multiplier.
Security Deposit Calculator
Try calculating the deposit yourself — change inputs and see the impact of each multiplier
Amount Before Multipliers
Final Security Deposit
Dual-Section Financial System
Each entity has a digital wallet with two independent sections: commissions and security. Every financial operation is recorded in an immutable audit trail.
Wallet Structure
Commission Section
Available Balance
Amount available for paying commissions and fees
Frozen
Reserved for commissions on active orders
Security Section
Available Balance
Amount available for securing new orders
Frozen
Reserved as guarantee for active orders
Internal Transfer
Funds can be transferred between the commission and security sections within the same wallet.
Freeze Cycle
1. Freeze
Reserve amount from available balance when order is created
2. Charge
Permanently deduct amount upon approval or settlement
3. Release
Return amount to available balance on cancellation or rejection
Debt Mechanism
When compensation exceeds the entity's balance, the system goes through 4 stages:
Deduct from frozen security first
Then from available security balance
Then from commission balance (down to zero)
Remainder becomes debt (negative security balance)
Debt prevents the entity from creating or receiving new orders until repayment.
Financial Operation Types
Commission Operations
Security Operations
Administrative Operations
Complete Dispute & Appeal System
When a disagreement occurs, any party can open a dispute reviewed by administration. Decisions can be appealed to senior management.
Dispute Flow
Open Dispute
Any party opens a dispute with description and evidence
Review
Administration reviews details and evidence
Decision
Resolve with compensation, reject, or consent agreement
Appeal System
Within 7 days of the decision · Senior Admin: confirm, overturn, or modify
Dispute Types
Opened by User
Fraud disputes automatically trigger an Anti-Money Laundering (AML) alert.
Auto-Generated by System
Compensation Sources
Platform
The platform bears the full compensation amount and deposits it in the affected party's wallet.
Counterparty
Compensation is deducted from the violating party's wallet and transferred to the affected party.
Split
The platform and counterparty share the compensation amount per administration's decision.
Appeal System
After a decision (resolve or reject), the opener may appeal within the deadline. Appeals are reviewed by Senior Admin (SuperAdmin) and cannot be appealed again.
Default appeal deadline: 7 days (adjustable by admin)Digital Contracts with Dual Signatures
Every entity must sign platform contracts both electronically and physically. No entity can operate without valid, signed contracts.
Template Lifecycle
Draft
Freely editable. Not yet published.
Active
Published and binding for all entities. Content is locked.
Revoked
Cancelled by admin decision. Cannot be reactivated.
Expired
Automatically expired. Replaced by a new version.
Dual Signing Tracks
Electronic Signature
SHA-256Entity owner signs electronically via the platform. A SHA-256 content hash is recorded along with IP address and timestamp.
Physical Signature
A printed copy is signed manually then uploaded as a file. Administration reviews and approves the file.
Contract Complete
When both signatures are complete, the contract becomes active and its validity period is calculated.
Physical Signature Stages
Awaiting Upload
Entity has not uploaded the file yet
Pending Review
File uploaded, awaiting admin review
Approved
Admin approved the physical signature
Rejected
Admin rejected the file with reason
Revision Requested
Admin requests a new file upload with grace period
Grace Period
When a new template is published or a contract expires, the entity gets a grace period to sign. During this period, normal operations continue.
Entity operates normally
Signing mandatory — platform blocks operations
Mandatory Enforcement
After the grace period ends, entities without signed contracts are automatically redirected to the signing page and cannot perform any operations until completion.
Entity owner → Redirected to signing page
Entity employee → Redirected to info page explaining owner must sign
Three Modes for Automatic Inventory Replenishment
When a merchant approves an incoming order from a shop, the system can automatically create an outgoing order to the supplier based on the configured policy.
Instant (Mirror)
Every approved incoming order instantly creates a matching outgoing order to the supplier — real-time supply with zero delay.
Instant outgoing order for each approved incoming order
Prevents duplicates via order linking (incoming → outgoing)
Auto-splits large orders based on maximum weight limit
Reorder Point
Continuously monitors the merchant's inventory — when it drops below a set threshold, automatically creates an order to the supplier.
Periodically checks effective inventory via the capacity system
Creates order when inventory drops below the reorder threshold
Prevents duplicate orders with atomic locking on the policy
Batch
Accumulates multiple incoming orders until reaching a weight, count, or time threshold, then creates a single consolidated order.
Accumulates until reaching any threshold: weight, count, or time
Single outgoing order combines all accumulated incoming orders
Links all incoming orders to the outgoing order (many-to-many)
Supply Job Lifecycle
Pending
Job created, waiting to execute
Processing
Creating the outgoing order
Completed
Order created successfully
Failed
Creation failed — awaiting retry
Manual
Retries exhausted — needs manual intervention
Automatic Retry
When order creation fails, the system automatically retries with exponential backoff. Default: 3 attempts with doubling delay between each.
When retries are exhausted: pause the policy, convert to manual, or notify admins only.
Price Protection
Price protection can be enabled to prevent creating orders when the price changes beyond the allowed tolerance. The system compares the price at job creation with the current price at execution.
Flexible Trading Limits Per Entity
Independent buy and sell limits can be set for each metal (gold and silver) per entity, with three enforcement levels.
Independent Limits Per Direction
Each entity has 4 separate limits that reset daily:
Gold Buy Limit
Gold Sell Limit
Silver Buy Limit
Silver Sell Limit
Enforcement Levels
Strict
Blocks order creation at the limit and auto-cancels excess pending orders.
Warning
Shows a warning to the user and requires confirmation before allowing the overage.
Disabled
No limits enforced — all orders pass without restrictions.
Limit Resolution Chain
Limits are resolved hierarchically — the most specific overrides the general:
Global
Entity Type
Tier
Plan
Entity
Link
Daily Auto-Reset
Consumption counters are reset daily via a scheduled command. The limits themselves don't change — only the calculated consumption restarts from zero.
Three Independent Protection Layers
Three protection systems work independently to ensure transaction safety — from full maintenance to automatic price volatility protection.
Maintenance Mode
Complete system shutdown for all or specific sections. Activated by senior admin only with advance scheduling capability.
4 independent sections: shops, merchants, suppliers, admin
Advance scheduling with auto-deactivation at estimated end
Allowed IPs list and emergency password for bypass
Manual Trading Halt
Immediate halt of all trading operations by admin decision. Automatically cancels all pending orders and requires manual reactivation.
Cancels all pending orders immediately with full refund
Records reason, responsible admin, and timestamp
Requires manual deactivation — does not expire automatically
Price Connection Guard
Self-healing automatic protection system — halts trading when price data issues are detected and resumes immediately when conditions normalize.
Redis connection to price server lost
Stale prices (no update for more than 5 seconds)
Market volatility index exceeds configured threshold
Trading resumes automatically when connection restores or prices update — no human intervention needed.
Market Volatility Scale
Index 0-100 that affects approval deadline and security deposit amount:
| Timeout Multiplier | Insurance Multiplier | ||
|---|---|---|---|
|
Stable
|
0 — 20 | 1× | 1× |
|
Moderate
|
21 — 50 | 0.75× | 1.2× |
|
High
|
51 — 80 | 0.5× | 1.5× |
|
Critical
|
81 — 100 | 0.3× | 2× |
Operations Allowed During Halt
Rejecting and cancelling orders is always allowed during any halt type — because these operations release frozen funds and reduce exposure.
Relationship Network Between Shops, Merchants & Suppliers
Every consignment operation requires an active partnership between the parties. Partnerships can be activated and deactivated with a complete audit trail.
Shop
Merchant
Supplier
Merchant ↔ Shop
Shop sends consignment orders to merchant. Merchant approves or rejects.
Supplier ↔ Merchant
Merchant requests supply from supplier. Supplier fulfills the order.
Deactivation Impact
Deactivate the link and record the reason and responsible party
Auto-cancel all pending orders between both parties with full refund
Reject pending action requests (cancellations/deliveries)
Previously approved orders are not affected — they continue to settlement.
Supplier Selection Strategies
Manual
Merchant manually selects the supplier for each order
Automatic
Selects the first supplier with automatic booking mode
Lowest Price
Supplier with the lowest average price in the last 30 days
Fastest Response
Supplier with the fastest average response time
Highest Approval
Supplier with the highest order approval rate
Reactivation
Partnerships can be reactivated at any time, but orders cancelled during deactivation are not restored — they must be created again.
Audit History
Every partnership state change is recorded in an immutable audit log:
Ready to Consign Digitally?
Amedha is the first platform of its kind. Join now and be among the first to benefit
Get Started