{"id":223054,"date":"2025-03-27T14:50:32","date_gmt":"2025-03-27T14:50:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/unicrow-cryptocurrency-escrow\/"},"modified":"2025-03-27T14:52:12","modified_gmt":"2025-03-27T14:52:12","slug":"unicrow-cryptocurrency-escrow","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/unicrow-cryptocurrency-escrow\/","author":23210001,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"6.7.5","requires":"6.0","requires_php":"7.0","requires_plugins":null,"header_name":"Unicrow: Cryptocurrency escrow","header_author":"Unicrow","header_description":"Integrates Unicrow, a non-custodial escrow for ETH and stablecoins, with WooCommerce and optionally Dokan","assets_banners_color":"faf9fd","last_updated":"2025-03-27 14:52:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/unicrow.io\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":421,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"unicrow","date":"2025-03-27 14:52:12"}},"upgrade_notice":{"1.0.0":"<p>Initial release<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3262931,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3262931,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3262931,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3262931,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3262931,"resolution":"1","location":"assets","locale":""},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3262931,"resolution":"10","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3262931,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3262931,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3262931,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3262931,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3262931,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3262931,"resolution":"7","location":"assets","locale":""},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3262931,"resolution":"8","location":"assets","locale":""},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3262931,"resolution":"9","location":"assets","locale":""}},"screenshots":{"1":"Unicrow checkout box with token selection","2":"Checkout box when only one token is set by the admin","3":"Payment request summary","4":"Wallet popped up asking for payment confirmation","5":"Payment confirmed in Unicrow app","6":"Email confirmation with escrow information","7":"Arbitrator's payment summary screen","8":"Arbitration form","9":"Payment ready to be claimed","10":"Seller's view of the payment with a refund button"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[144658,150369,18737,1887,229171],"plugin_category":[45],"plugin_contributors":[240060],"plugin_business_model":[],"class_list":["post-223054","plugin","type-plugin","status-closed","hentry","plugin_tags-cryptocurrencies","plugin_tags-escrow","plugin_tags-ethereum","plugin_tags-payments","plugin_tags-stablecoins","plugin_category-ecommerce","plugin_contributors-unicrow","plugin_committers-unicrow"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/unicrow-cryptocurrency-escrow_faf9fd.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-1.png?rev=3262931","caption":"Unicrow checkout box with token selection"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-2.png?rev=3262931","caption":"Checkout box when only one token is set by the admin"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-3.png?rev=3262931","caption":"Payment request summary"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-4.png?rev=3262931","caption":"Wallet popped up asking for payment confirmation"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-5.png?rev=3262931","caption":"Payment confirmed in Unicrow app"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-6.png?rev=3262931","caption":"Email confirmation with escrow information"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-7.png?rev=3262931","caption":"Arbitrator's payment summary screen"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-8.png?rev=3262931","caption":"Arbitration form"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-9.png?rev=3262931","caption":"Payment ready to be claimed"},{"src":"https:\/\/ps.w.org\/unicrow-cryptocurrency-escrow\/assets\/screenshot-10.png?rev=3262931","caption":"Seller's view of the payment with a refund button"}],"raw_content":"<!--section=description-->\n<p>The plugin makes it easy to integrate <em>Unicrow<\/em> into a marketplace built on <em>WooCommerce<\/em> and optionally <em>Dokan<\/em>.\nIt extends <em>WooCommerce<\/em> and <em>Dokan<\/em> settings to allow admins to configure its parameters<\/p>\n\nOverview\n\n<p>There are a few things important to understand before we get into the (very simple) setup.<\/p>\n\n<h3>About _Unicrow_<\/h3>\n\n<p>To better grasp the potential that <em>Unicrow<\/em> brings to marketplace operators, it is good to understand the protocol basics.\n* <em>Unicrow<\/em> runs on Ethereum's Layer 2s  <em>Arbitrum One<\/em> and <em>Base<\/em> and supports <em>ETH<\/em> and any ERC20 token, e.g. stablecoins like <em>USDT<\/em> or <em>USDC<\/em>\n* Each individual escrow has the following parameters: <em>seller<\/em> (supposed to receive the funds), <em>marketplace<\/em> (optional, gets a commission), <em>arbitrator<\/em> (optional, decides a dispute), and what's the <em>challenge<\/em> (escrow) <em>period<\/em>.\n* The <em>Buyer<\/em> can release funds to the <em>seller<\/em> at any time\n* Funds can be claimed to the <em>seller<\/em> after the <em>challenge period<\/em> ends\n* The <em>Marketplace<\/em> and\/or <em>arbitrator<\/em> fees will be sent out when the funds are claimed or released from the escrow.\n* <em>Unicrow<\/em> is <em>immutable<\/em> and <em>non-custodial<\/em>\nYou can read more details at <a href=\"https:\/\/docs.unicrow.io\/docs\/introduction\/summary\">docs.unicrow.io<\/a>. \nThe <a href=\"https:\/\/docs.unicrow.io\/docs\/quick-start\/basic-concepts\">Quick Start<\/a> section of our documentation website includes useful information for users. Feel free to copy&amp;paste any of the content or refer to it in your marketplace user guides.<\/p>\n\n<h3>Supported tokens<\/h3>\n\n<p>The plugin supports <em>ETH<\/em>, <em>USDC<\/em>, and <em>USDT<\/em> on <em>Arbitrum One<\/em> network. We will extend the support for <em>Base<\/em> soon and for additional tokens based on feedback and eventually make it easier for admins to add support for any tokens. In the meantime, the admins can extend support in the source code directly (see Advanced Setup below)<\/p>\n\nSupported functionality\n\n<h3>WooCommerce<\/h3>\n\n<p><em>Unicrow<\/em> plugin extends <em>Wooommerce<\/em> (WC) in the following ways:\n* It is added to a list of payment methods in WC's settings and on the checkout page\n* It adds an optional <em>seller address<\/em> attribute to product settings\u200a-\u200athis technically allows operating a multi-vendor marketplace even without <em>Dokan<\/em>, simply by adding different <em>seller address<\/em> to different products.\n* It adds a link to the transaction in <em>Unicrow<\/em> web3 app to admin emails and to the order notes.<\/p>\n\n<h3>Dokan<\/h3>\n\n<p>The plugin further adds or reuses the following to <em>Dokan<\/em> settings:\n* It uses <em>Dokan<\/em>'s admin commission as a <em>marketplace fee<\/em> parameter in <em>Unicrow<\/em> transactions\n* It adds <em>seller address<\/em> parameter to vendor settings and if set, uses it in the transactions (in that case, setting <em>seller address<\/em> in product settings or <em>WooCommerce<\/em> Payment settings is not necessary)\n* It adds to an email sent to the vendor a note with a link to the transaction in <em>Unicrow<\/em> web3 app<\/p>\n\nPrerequisites\n\n<h3>Wordpress plugins:<\/h3>\n\n<ul>\n<li><em>WooCommerce<\/em> is a required and technically sufficient pre-requisite since <em>Unicrow<\/em> plugin hooks into its functions for setting up and for payment processing.\u00a0\nWhile <em>WooCommerce<\/em> itself doesn't support multi-vendor setup, <em>Unicrow<\/em> extends product settings for <em>seller address<\/em> attribute.\nThat means if an admin doesn't want to complicate things with multiple sellers and an additional plugin such as <em>Dokan<\/em>, but wants to be able to process payments to different addresses for different products, the combination of WC and <em>Unicrow<\/em> allows for this.<\/li>\n<li>(Optional) <em>Dokan<\/em> for full multi-vendor functionality.<\/li>\n<\/ul>\n\n<h3>Other\/Crypto-related prerequisites for different actors:<\/h3>\n\n<ul>\n<li>Marketplace operator\n\n<ul>\n<li>A secure wallet able to receive fees (if applicable) on the supported network<\/li>\n<li>An online web3 wallet to provide arbitration service loaded with a little bit bit of <em>ETH<\/em> to pay for gas costs\u00a0<\/li>\n<li>(optional) An online web3 wallet that would regularly claim payments to _sellers as a service to them (for simplification it can be done also from the Arbitrator wallet)<\/li>\n<\/ul><\/li>\n<li>Buyer\n\n<ul>\n<li>A web3 wallet with sufficient balance to pay the purchase and a little bit of <em>ETH<\/em> on the supported network<\/li>\n<\/ul><\/li>\n<li>Seller\n\n<ul>\n<li>An Ethereum address to receive the supported tokens on the supported network<\/li>\n<\/ul><\/li>\n<\/ul>\n\nSetting Up\n\n<p>Follow these steps to set up <em>Unicrow<\/em> with WooCommerce and, optionally, <em>Dokan<\/em>\n1. Open Wordpress Admin Console\n1. Install and activate <em>WooCommerce<\/em>, <em>Unicrow WooCommerce plugin<\/em>, and optionally <em>Dokan<\/em>\n2. Open <strong><em>WooCommerce<\/em> \u2192 Settings \u2192 Payments<\/strong> and press Manage next to <em>Unicrow<\/em>\n3. Enter the values per your preference:\n    * <strong>Default Seller Address<\/strong>: If you plan to receive all payments to one address, paste that address here. Leave it empty if you plan to set <em>seller address<\/em> per product or (in <em>Dokan<\/em>) per vendor\n    * <strong>Marketplace Address<\/strong>: If you plan to collect a commission directly from <em>Unicrow<\/em> to your wallet, paste its address here. This can be a cold wallet or even an exchange address as long as it supports receiving the tokens you chose on the supported network (currently <em>Arbitrum One<\/em> TODO: add link to arbitrum guide).\n    * <strong>Marketplace Commission<\/strong>: Leave empty if you want the plugin to reuse <em>Dokan<\/em> commission settings or if you don't plan to charge a commission.\n    * <strong>Challenge Period<\/strong>: How long a buyer can challenge the payment. After this, the <em>seller<\/em> can claim the payment.\n    * <strong>Arbitrator address<\/strong>: An address of a wallet account from which you will resolve disputes. The address should be funded with a little bit of <em>ETH<\/em> for gas fees and easy to access and make transactions from, e.g. a browser or even a mobile wallet. It won't hold customer funds at any point so it can be \"hot\".\n    * <strong>Arbitrator fee<\/strong>: Arbitrator fee in %. If the marketplace operator is an arbitrator too, can leave this at 0.\n    * <strong>Accepted tokens<\/strong>: Currently supporting <em>ETH<\/em>, <em>USDT<\/em>, <em>USDC<\/em>. We'd like your feedback which ones we should prioritize and will eventually let you manage a custom list (which you of course can still do by opening the plugin code and editing config.php :-)\n4. If you use <em>Dokan<\/em>, you can set <em>seller address<\/em> per vendor in <strong>Users -&gt; All Users -&gt; Edit -&gt; Unicrow Vendor Options<\/strong><\/p>\n\nAdvanced Setup\n\n<p>Please don't hesitate to contact us at hello@unicrow.io to suggest improvements, but in the meantime if you want to add some other ERC20 token to the list or switch the plugin to support <em>Base<\/em>, you can do it by editing the plugin code using a plugin like <a href=\"https:\/\/wordpress.org\/plugins\/wpide\/\">WPIDE<\/a>:\n* To add a custom ERC20 token, edit <em>config.php<\/em> \n    *  In this case, we'd recommend to edit the description to reflect this too\n* To switch to <em>Base<\/em>, edit <em>src\/class-wc-gateway-unicrow.php<\/em> and change <code>'chainId' =&gt; 42161,<\/code> to <code>8453<\/code><\/p>\n\n<h3>External services<\/h3>\n\n<p>The plugin reads ETH price from Coingecko's public API (api.coingecko.com).\nIt also connects to Unicrow's REST API to create a payment request in Unicrow's app. Subsequently it redirects a user to the app to pay the re request and uses the provided callback url to send the user back to the confirmation page.\nThe data submitted to the REST API are:\n* order price\n* order number\n* buyer, seller, marketplace, and arbitrator ETH addresses\n* marketplace and arbitrator commissions\n* escrow period<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='what%20cryptocurrencies%20and%20networks%20are%20supported%3F'><h3>What cryptocurrencies and networks are supported?<\/h3><\/dt>\n<dd><p>ETH, USDC, and USDT on Arbitrum One.<\/p><\/dd>\n<dt id='will%20you%20add%20more%20tokens%20and%20networks'><h3>Will you add more tokens and networks<\/h3><\/dt>\n<dd><p>Yes, we'll add support for Base (which is already supported by Unicrow) and more tokens based on feedback<\/p><\/dd>\n<dt id='can%20i%20add%20support%20for%20a%20specific%20token%20myself%3F'><h3>Can I add support for a specific token myself?<\/h3><\/dt>\n<dd><p>Yes, edit the config.php file and add your preferred token information<\/p><\/dd>\n<dt id='is%20dokan%20required%3F'><h3>Is Dokan required?<\/h3><\/dt>\n<dd><p>No, WooCommerce is sufficient, but Dokan adds additional multi-vendor functionality.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Unicrow is a non-custodial escrow protocol for ETH, stablecoins, and other ERC20 tokens. This integrates it into a WooCommerce and optionally Dokan","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/223054","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=223054"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/unicrow"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=223054"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=223054"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=223054"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=223054"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=223054"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=223054"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}