{"id":4909,"date":"2025-11-27T08:02:18","date_gmt":"2025-11-27T08:02:18","guid":{"rendered":"https:\/\/blog.mathwallet.org\/?p=4909"},"modified":"2026-02-05T02:33:20","modified_gmt":"2026-02-05T02:33:20","slug":"mathpay-x402-facilitator-guide","status":"publish","type":"post","link":"https:\/\/blog.mathwallet.org\/?p=4909","title":{"rendered":"MathPay x402 Facilitator Guide"},"content":{"rendered":"\n<p>This document describes how to integrate and use the x402 protocol through the MathPay Facilitator service.<strong><\/strong><\/p>\n\n\n\n<p><strong>MathPay Facilitator URL&nbsp;: &nbsp;<\/strong><a href=\"https:\/\/facilitator.mathpay.org\"><strong><u><strong>https:\/\/facilitator.mathpay.org<\/strong><\/u><\/strong><\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<h2><strong>1. <\/strong><strong>Register a MathPay Account<\/strong><strong><\/strong><\/h2>\n\n\n\n<p>Please register and log in to your MathPay account&nbsp;:&nbsp;<a href=\"https:\/\/app.mathpay.org\">https:\/\/app.mathpay.org<\/a><\/p>\n\n\n\n<p>Guide: <a href=\"https:\/\/blog.mathwallet.org\/?p=4854\">https:\/\/blog.mathwallet.org\/?p=4854<\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<h2><strong>2. Complete KYC and Obtain Your API Key<\/strong><strong><\/strong><\/h2>\n\n\n\n<p>After completing KYC, you can view and manage your <strong>MathPay API Key<\/strong>&nbsp;under<\/p>\n\n\n\n<p><strong>Settings<\/strong>&nbsp;\u2192 <strong>API<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" src=\"https:\/\/mathwallet.oss-cn-hangzhou.aliyuncs.com\/blog\/2025\/11\/mathpay-x402\/001.png\" alt=\"\" width=\"561\" height=\"279\"\/><\/figure>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<h2><strong>3. Include Your API Key in Requests<\/strong><strong><\/strong><\/h2>\n\n\n\n<p>When calling the \/verify or \/settle endpoints of the MathPay Facilitator, you must include your API Key in the request header as follows:<\/p>\n\n\n\n<p><strong>X402-MATHPAY-API-KEY: your-mathpay-api-key<\/strong><\/p>\n\n\n\n<h2><strong>Supported Endpoints<\/strong><strong><\/strong><\/h2>\n\n\n\n<p>The MathPay Facilitator currently supports the following endpoints:<\/p>\n\n\n\n<p><strong>\u2022<\/strong><strong> <\/strong><strong>\/verify<\/strong><strong><\/strong><\/p>\n\n\n\n<p><strong>\u2022<\/strong><strong> <\/strong><strong>\/settle<\/strong><strong><\/strong><\/p>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<p><strong>Supported Networks<\/strong><strong><\/strong><\/p>\n\n\n\n<p>MathPay Facilitator currently supports the x402 protocol on:<\/p>\n\n\n\n<p>Base, BNBChain<\/p>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<h2><strong>x402 <\/strong><strong>Architecture Overview<\/strong><strong><\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" src=\"https:\/\/mathwallet.oss-cn-hangzhou.aliyuncs.com\/blog\/2025\/11\/mathpay-x402\/002.png\" alt=\"\" width=\"577\" height=\"409\"\/><\/figure>\n\n\n\n<hr class=\"wp-block-separator\"\/>\n\n\n\n<h2><strong>&nbsp;<\/strong><\/h2>\n\n\n\n<h2><strong>Reference Documentation<\/strong><strong><\/strong><\/h2>\n\n\n\n<p>x402 Protocol Official Documentation\uff1a<a href=\"https:\/\/x402.gitbook.io\/x402\">https:\/\/x402.gitbook.io\/x402<\/a><\/p>\n\n\n\n<p>Note: MathPay x402 currently in beta testing phase, if you&#8217;d like to join the test, please send email to <a href=\"mailto:labs@mathwallet.org\">labs@mathwallet.org<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This document describes how to integrate and use the x402 protocol through the MathPay Facilitator service. MathPay Facilitator URL&nbsp;: &nbsp;https:\/\/facilitator.mathpay.org 1. Register a MathPay Account Please register and log in to your MathPay account&nbsp;:&nbsp;https:\/\/app.mathpay.org Guide: https:\/\/blog.mathwallet.org\/?p=4854 2. Complete KYC and Obtain Your API Key After completing KYC, you can view and manage your MathPay API [&hellip;]<\/p>\n","protected":false},"author":8,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"unlock_protocol_post_locks":""},"categories":[1],"tags":[159,165],"_links":{"self":[{"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/posts\/4909"}],"collection":[{"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=4909"}],"version-history":[{"count":5,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/posts\/4909\/revisions"}],"predecessor-version":[{"id":4948,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=\/wp\/v2\/posts\/4909\/revisions\/4948"}],"wp:attachment":[{"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4909"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=4909"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mathwallet.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=4909"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}