<h1 class="title">WeChat API</h1> <p>Basic tools to integrate Odoo and WeChat.</p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#payment-methods" id="id1">Payment methods</a><ul> <li><a class="reference internal" href="#quick-pay-micropay" id="id2">Quick Pay (micropay)</a></li> <li><a class="reference internal" href="#native-payment-qr-code-payment" id="id3">Native Payment (QR Code Payment)</a></li> <li><a class="reference internal" href="#official-account-payment" id="id4">Official Account Payment</a></li> <li><a class="reference internal" href="#in-app-payment" id="id5">In-App Payment</a></li> </ul> </li> <li><a class="reference internal" href="#wechat-documentation-tools" id="id6">WeChat Documentation &amp; tools</a><ul> <li><a class="reference internal" href="#sandbox-debugging" id="id7">Sandbox &amp; Debugging</a></li> <li><a class="reference internal" href="#payments" id="id8">Payments</a></li> </ul> </li> <li><a class="reference internal" href="#debugging" id="id9">Debugging</a><ul> <li><a class="reference internal" href="#local-debug" id="id10">Local Debug</a></li> <li><a class="reference internal" href="#native-payments-debugging" id="id11">Native Payments debugging</a></li> </ul> </li> <li><a class="reference internal" href="#credits" id="id12">Credits</a><ul> <li><a class="reference internal" href="#contributors" id="id13">Contributors</a></li> <li><a class="reference internal" href="#sponsors" id="id14">Sponsors</a></li> <li><a class="reference internal" href="#maintainers" id="id15">Maintainers</a></li> </ul> </li> <li><a class="reference internal" href="#further-information" id="id16">Further information</a></li> </ul> </div> <a name="payment-methods"></a> <h2><a class="toc-backref" href="#id1">Payment methods</a></h2> <a name="quick-pay-micropay"></a> <h3><a class="toc-backref" href="#id2">Quick Pay (micropay)</a></h3> <p>Buyer presents the pay code, Vendor scans the code to finish the transaction.</p> <a name="native-payment-qr-code-payment"></a> <h3><a class="toc-backref" href="#id3">Native Payment (QR Code Payment)</a></h3> <p>The Vendor gets one-time url and shows it to Buyer as a QR Code, Buyer scans to finish the transaction.</p> <a name="official-account-payment"></a> <h3><a class="toc-backref" href="#id4">Official Account Payment</a></h3> <p>There are two types of usage:</p> <ul class="simple"> <li><strong>In-App Web-based Payment</strong> -- The Payer opens the Vendor's HTML5 pages on their WeChat and calls the WeChat payment module via the JSAPI interface to pay their transaction. Client side of this process (i.e. web pages) is not supported. While it could be implemented as additional module, we recommend to develop <em>Mini programs</em> instead.</li> <li><strong>Mini program</strong> -- an application as a part of WeChat App is created via <em>WeChat Developer tools</em>.</li> </ul> <a name="in-app-payment"></a> <h3><a class="toc-backref" href="#id5">In-App Payment</a></h3> <p>This payment way is only for native mobile application. This module provides server part of the process.</p> <a name="wechat-documentation-tools"></a> <h2><a class="toc-backref" href="#id6">WeChat Documentation &amp; tools</a></h2> <a name="sandbox-debugging"></a> <h3><a class="toc-backref" href="#id7">Sandbox &amp; Debugging</a></h3> <ul class="simple"> <li>API Debug Console <a class="reference external" href="https://open.wechat.com/cgi-bin/newreadtemplate?t=overseas_open/docs/oa/basic-info/debug-console">https://open.wechat.com/cgi-bin/newreadtemplate?t=overseas_open/docs/oa/basic-info/debug-console</a></li> <li>Creating Test Accounts <a class="reference external" href="https://admin.wechat.com/debug/cgi-bin/sandbox?t=sandbox/login">https://admin.wechat.com/debug/cgi-bin/sandbox?t=sandbox/login</a><ul> <li>Note: it may not work from non-chinese IP addresses</li> <li>You will get <code>appid</code> and <code>appsecret</code> values</li> <li>To work with WeChat payments you also need Merchant ID, which this sandbox doesn't provide. It seems, that to work with Payments you need a real account and use <em>sandbox</em> mode (<em>System Parameter</em> <code>wechat.sandbox</code>).</li> </ul> </li> </ul> <a name="payments"></a> <h3><a class="toc-backref" href="#id8">Payments</a></h3> <ul class="simple"> <li><a class="reference external" href="https://pay.weixin.qq.com/wechatpay_guide/help_docs.shtml">https://pay.weixin.qq.com/wechatpay_guide/help_docs.shtml</a></li> </ul> <a name="debugging"></a> <h2><a class="toc-backref" href="#id9">Debugging</a></h2> <a name="local-debug"></a> <h3><a class="toc-backref" href="#id10">Local Debug</a></h3> <p>To debug UI, create <em>System Parameter</em> <code>wechat.local_sandbox</code> with value <code>1</code>. All requests to wechat will return fake result without making a request.</p> <a name="native-payments-debugging"></a> <h3><a class="toc-backref" href="#id11">Native Payments debugging</a></h3> <ul class="simple"> <li>It seems that in sandbox mode it's allowed to use only prices <code>1.01</code> and <code>1.02</code>.</li> </ul> <a name="credits"></a> <h2><a class="toc-backref" href="#id12">Credits</a></h2> <a name="contributors"></a> <h3><a class="toc-backref" href="#id13">Contributors</a></h3> <ul class="simple"> <li><a class="reference external" href="https://it-projects.info/team/yelizariev">Ivan Yelizariev</a></li> </ul> <a name="sponsors"></a> <h3><a class="toc-backref" href="#id14">Sponsors</a></h3> <ul class="simple"> <li><a class="reference external" href="http://sinomate.net/">Sinomate</a></li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id15">Maintainers</a></h3> <ul class="simple"> <li><a class="reference external" href="https://it-projects.info">IT-Projects LLC</a></li> </ul> <a name="further-information"></a> <h2><a class="toc-backref" href="#id16">Further information</a></h2> <p>Demo: <a class="reference external" href="http://runbot.it-projects.info/demo/misc-addons/13.0">http://runbot.it-projects.info/demo/misc-addons/13.0</a></p> <p>HTML Description: <a class="reference external" href="https://apps.odoo.com/apps/modules/13.0/wechat/">https://apps.odoo.com/apps/modules/13.0/wechat/</a></p> <p>Usage instructions: <a class="reference external" href="doc/index.rst">doc/index.rst</a></p> <p>Changelog: <a class="reference external" href="doc/changelog.rst">doc/changelog.rst</a></p> <p>Tested on Odoo 12.0 b05e34a0d9b13a1c6971b99ed3e5fa20199f3545</p>