বাইরের প্রোভাইডার দিয়ে Escrow
Escrow.com প্লাগইন ও escrow সেটিংস সেটআপ, ক্রেতা হিসেবে escrow দিয়ে পেমেন্ট, escrow দিয়ে বেচা, মার্কেটপ্লেস কী হিসাব করে (শুধু broker fee), আর Finance → Escrow-এর sync, cancel ও webhook URL।
Since 1.7.0 a sale can be paid through a licensed escrow service instead of the marketplace's own payment gateways. The service holds the buyer's money, the seller transfers the domain, the buyer accepts, and the service pays the seller and the marketplace's commission. AIODomain is not an escrow agent and never holds these funds; it opens the transaction, follows it and keeps the record. The first provider is Escrow.com; others can be added as plugins.
1. Setting it up (owner)
- Open an account at the provider (Escrow.com: a business account, API access, and "broker" approval if the marketplace commission should be paid out of the transaction). Get the API e-mail and API key; start in the sandbox.
- Settings -> Plugins: switch the Escrow.com plugin on and fill its settings: API e-mail, API key, sandbox on/off, who pays the escrow fee (buyer, seller, split), broker mode (on: the marketplace is a party with the commission as a broker fee; off: no broker line, the commission is settled with the seller later).
- Register the webhook URL shown on the plugin page and on Finance -> Escrow at the provider. A webhook only tells the marketplace to re-read the transaction; it never changes anything by itself.
- Settings -> Payments & Fees -> Escrow: switch escrow on, choose the provider, set the minimum amount from which escrow is offered (0 = always), the amount above which escrow is the only way to pay (0 = never), the hours the buyer has to fund the transaction, how often open transactions are re-read, and the text shown to buyers.
Nothing of this exists for buyers until a provider plugin with its keys is on; the escrow option never appears without one.
2. Paying through escrow (buyer)
On the order page the payment methods include Escrow via <provider> with the provider's fee estimate, who pays it, and the badge "Funds held by a licensed escrow service, never by the marketplace". Above the threshold it is the only method. Click Pay through escrow: the marketplace opens the transaction at the provider in your name and the seller's, with the domain as the item and the marketplace as the broker, and shows the escrow box: the status, the reference, the steps (Opened -> Funds secured -> Domain handed over -> Accepted -> Funds released) and the button Pay at <provider>. Pay there (card, wire, as the provider allows). You can cancel while the transaction is only opened; once funded, cancellations go through the provider or the marketplace team.
When the provider confirms the funds, the order becomes paid and the usual transfer workflow starts (chapter Domain transfers). When the domain is in your account, click Confirm receipt on the order page: this accepts the domain at the provider and releases the money to the seller. You may also accept at the provider directly; the marketplace picks the change up on the next sync or webhook. Sync with <provider> re-reads the transaction on demand.
3. Selling through escrow (seller)
You are told when a buyer opens an escrow transaction; the provider may ask you to sign in or open an account with the e-mail address of your marketplace account. When the funds are secured the sale page asks you to transfer the domain as usual; marking the transfer done tells the provider the item was handed over. After the buyer accepts, the provider pays you directly: the sale page's money box says "Paid by <provider> directly", nothing goes through your marketplace balance, and the commission (plus the marketplace fee) is taken as the broker fee. The invoice and the order history stay as for any sale.
4. What the marketplace books
For an escrow sale the ledger holds exactly one posting at completion: the broker fee received from the provider (debit cash, credit revenue). The payment row on the order says "Held by <provider>" so the Payments page tells escrow sales from gateway sales. No seller balance, hold or payout is involved, and the Refund action is disabled: a refund or a cancellation of a funded transaction happens at the provider, and the marketplace follows (order refunded, listing back on the market).
5. Finance -> Escrow (admin)
Tiles (open, waiting for payment, funds secured, handed over, released with their value, value currently held at the provider, commission earned, disputed, sync errors), tabs Open / Needs attention (disputes, sync errors, transactions opened but not funded for three days, funded but not handed over for ten) / All / per status, search, CSV. A record shows the order and both parties, the provider reference (with the sandbox marker), the amounts and fees, the step tracker, timestamps, every event (webhook, poll, button, with the provider's data), and the actions: Sync now, Cancel at the provider (reason), Act for the buyer: accept (audited), plus the provider set-up block with the webhook URL. The cron job escrow_sync re-reads open transactions every few hours; the order record links to its escrow transaction.
A dispute opened at the provider marks the order disputed and tells the team; it is handled at the provider, and the outcome (release or refund) reaches the marketplace through the sync.