Which languages are available at checkout?

Choose from multiple checkout languages, including English, Chinese, Spanish, and more. HPP, ON_SITE, social payment pages and subscription checkout show the available choices. Installed plugins may need a frontend update to offer newly added languages. Merchant-written content keeps its original language.

MochiPay Help Center

Questions answered. Payments made clearer.

Find practical information about MochiPay accounts, customer payments, API integrations and subscription access.

Frequently asked questions

Everything you need to know

Select a question to view a clear answer. Technical request examples are available in the developer documentation.

01

About MochiPay

Platform and account basics

Which backend and mobile demos are available?

Use PHP, Node.js, Python, C# or Java on your backend, plus Swift for iOS and Kotlin for Android. All support ON_SITE and HPP. Setup instructions stay in English; checkout supports multiple languages.

Code examples · Returns & notifications
Does verification depend on the customer returning?

No. HPP has a browser return and a separate server notification. ON_SITE uses server notifications too. Your backend verifies the saved payment and updates the order once, even if checkout is closed. Polling updates the display.

Code examples · Returns & notifications
Does MochiPay charge a payment transaction commission?

MochiPay charges only a platform subscription fee. Customer payments go directly to your receiving wallet, with no percentage deducted by MochiPay.

What is MochiPay?

MochiPay is a cryptocurrency payment platform. Use payment links, social payment pages, store plugins or APIs to collect crypto and track payments. ON_SITE and HPP are available for plugins and custom API integrations; Classic SaaS uses HPP only.

Who can use MochiPay?

MochiPay is designed for online businesses, creators, communities, fundraisers, developers, SaaS platforms, independent stores and applications that need structured crypto payment capabilities.

Do I need technical experience to start?

No. Anyone with a MochiPay account can create a payment request and copy its hosted link directly from the dashboard. Developers can use the API when deeper automation is required.

02

Payments

Checkout, networks and payment status

How does a customer payment work?

An account holder creates a payment request through the dashboard or API and shares the generated link. The payer sends the exact amount using the asset and network shown on checkout.

Can I share a payment link without posting my wallet address publicly?

Yes. You can share the MochiPay hosted payment link on social media, in a message, by email or on a campaign page instead of publishing your wallet address directly. The payer will still see the assigned payment address after opening the checkout page, and the resulting blockchain transaction remains public.

Can I use MochiPay for tips, crowdfunding or donations?

Yes, provided the activity is lawful and complies with the MochiPay Terms. You can create separate payment requests for tips, fundraising, donations, community projects or temporary collections and review each received payment in the dashboard. MochiPay does not determine whether a contribution is tax-deductible.

Does MochiPay hold or receive the funds first?

No third-party payment processor receives the funds first. The payer sends cryptocurrency on-chain to one of the account holder's enabled receiving wallets. MochiPay monitors the transaction, matches the exact amount to the order and updates its status.

How do I manage a MochiPay receiving wallet in MetaMask or another wallet?

A MochiPay HD wallet is controlled by its BIP-39 recovery phrase. Back it up during creation, then import that phrase into a compatible wallet application when you need to view or move funds.

  1. Install a trusted wallet from its official website or app store. MetaMask supports Ethereum-compatible networks; Phantom or another Solana-compatible wallet can be used for SOL; choose a wallet that explicitly supports Bitcoin or TRON when those networks are required.
  2. Select Import wallet or Import using recovery phrase, then enter the 12 words in the exact order shown when the MochiPay wallet was created.
  3. Add or select the correct blockchain network and token contract. The asset, network and contract must match the corresponding record in MochiPay.
  4. Compare the receiving address displayed by the wallet application with the address shown by MochiPay for that network before moving funds.

Security: Never paste the recovery phrase into a website, support chat or browser page. Anyone with the phrase can control the funds. Test with a small amount before making a larger transfer.

How do I pay with a wallet such as MetaMask?

First confirm that your wallet supports the exact asset and network displayed on the MochiPay checkout page. For a MetaMask-compatible network, follow these steps:

  1. Open MetaMask and switch to the network shown on checkout.
  2. Select the required token, choose Send, and paste the payment address from checkout.
  3. Enter the exact payment amount shown by MochiPay. Do not round or change it.
  4. Check the token, network, address and amount again, then confirm the transaction in your wallet.
  5. Return to the MochiPay checkout page and wait while the blockchain transaction and required confirmations are detected.

Important: Keep enough of the network's native coin to pay the blockchain fee. If MetaMask does not support the displayed network, use a wallet that does. Never send through a different network, and never share your recovery phrase or private key with MochiPay, the recipient or anyone else.

Which currencies and networks are supported?

Available currencies and networks depend on the assets currently enabled by the MochiPay platform. Always use the asset and network displayed on the payment page.

Why must the exact network be used?

Blockchain transactions are network-specific. Sending through a different network may prevent the payment from being detected correctly.

How is payment status monitored?

On-site and HPP interfaces automatically check payment status through the integration’s server-side verification. Account holders can also view the order in the dashboard or query it through the API.

03

Integrations

API, plugins and automated applications

Does MochiPay provide APIs?

Yes. Developers can create payment orders and query order status through authenticated API endpoints. Request formats and examples are available in the developer documentation.

Can I use MochiPay without an API integration?

Yes. You can create an order in the dashboard and share the hosted payment link directly with the payer.

Which store integrations are available?

The developer area offers 19 separate plugin ZIPs for 12 store families: WooCommerce, OpenCart, Zen Cart, Magento, PrestaShop, Shopware, Drupal Commerce, EC-CUBE, Bagisto, Sylius, osCommerce and thirty bees. Choose the matching core branch and PHP environment. Every ZIP includes English instructions; all offer ON_SITE and HPP. Classic SaaS uses HPP only.

What is the difference between ON_SITE and HPP?

ON_SITE displays the payment dialog, exact amount, receiving address, QR code and status on your own checkout page. HPP (Hosted Payment Page) redirects the customer to a payment page hosted by MochiPay, then returns them to your configured URL. Both modes use the same payment order and send funds directly to your receiving wallet. Your backend verifies payment before marking the order paid. All standalone plugins and custom API/PHP integrations support both modes; Classic SaaS and dashboard payment links use HPP only.

Is there a free MochiPay AI integration skill?

Yes. Download our free English skill for plugin selection, exact core/PHP requirements, ON_SITE/HPP API integration and troubleshooting. It includes optional offline Python checks. Install it through your AI tool's supported skills workflow; it does not grant account access or replace your private merchant configuration. MochiPay subscriptions and AI-tool requirements are separate.

Download the skill and follow the installation guide →

Why choose ON_SITE for checkout?

ON_SITE keeps customers in your familiar store and removes the extra redirect to a separate payment page. This can reduce checkout abandonment and improve payment completion. It is the default for the standalone plugins and PHP Demo. The actual improvement depends on your checkout, traffic and customers; compare completed payments in your own funnel. HPP remains available when you prefer a ready-made hosted payment page.

Can customers pay without leaving my website?

Yes. All standalone store plugins support on-site and HPP, with on-site as the default. Custom API integrations and the PHP Demo support both experiences using the same payment order. Classic SaaS integrations use HPP only. The on-site browser displays payment instructions while your own backend signs API requests and verifies the result.

Can AI applications and other AI agents use MochiPay?

AI services can create and track payment requests with the API or MCP tools. Your application verifies payment; MochiPay does not sign wallet transactions or send funds.

04

Subscriptions & Accounts

Plans, renewals and account access

What subscription plans are available?

MochiPay offers monthly, quarterly and yearly subscription periods. Current prices are shown on the pricing page.

Can I choose a different plan when renewing?

Yes. During renewal you can keep the current plan or select another available subscription period before making payment.

How is sensitive information protected?

Back up the recovery phrase privately during creation. Never send it through support messages or customer fields. Read the current wallet and security model →

05

Social payment pages

Bio links, social sharing and flexible payments

Can I accept social payments without a store?

Yes. Create a Social Payment Page for your bio, pinned posts or direct messages. Choose free, suggested or fixed crypto amounts, eight page templates, twelve colors and three QR designs. Customize notes and contact collection. ON_SITE opens a payment popup and HPP redirects. Each continued payment becomes a separate order; the server verifies PAID before showing the paid receipt and success button.

Which currencies and amounts can a payer enter?

Free and suggested pages can offer USDT on TRON, USDC on Ethereum, BTC on Bitcoin, ETH on Ethereum and SOL on Solana. Fixed pages offer one configured asset and network. Only selected active methods with an active receiving wallet appear. Amounts are crypto quantities; suggested quantities apply only to their configured currency. Notes and contact details can be optional or required. Native TRX on TRON.

How do ON_SITE and HPP work on a social payment page?

ON_SITE is the default and opens a payment dialog over your reusable MochiPay checkout page, keeping your page design visible behind it. Closing and reopening the dialog continues the same order without creating another one or extending its expiry. HPP redirects to the MochiPay hosted payment screen. Both use the same payment verification and merchant receiving wallet. These shared pages are hosted on MochiPay; native plugins and API integrations are available for checkout on your own store domain.

Does opening the shared QR create an order or send money?

No. The shared QR opens the social payment page. An order is created only when the payer continues to payment using the free, suggested or fixed amount rules. The payment screen shows the receiving address, network, payment QR and exact amount. The payer must use the correct network and must not round the displayed amount.

How do I confirm a checkout-page payment?

Check the order status in the merchant dashboard. View page orders filters orders for one checkout page, and order details show the payer note. Only server-verified PAID orders show a paid receipt. A redirect, browser message or screenshot is not proof of payment.

Can I edit or pause a page after sharing its QR?

Yes. Editing the title, description or design keeps the same link. Previously downloaded QR artwork keeps its printed text but opens the updated page. Pausing prevents new orders; payment orders already created can still be completed under their original payment rules.

Do I need a separate wallet for each checkout currency?

No. Social payment pages reuse your existing active merchant HD receiving wallet and the supported asset/network settings. An active subscription is required to create new payment orders. No API development, shopping cart, inventory or delivery setup is required to use a shared checkout page.

Why does my checkout page say Checkout unavailable?

Check that the page is enabled, the merchant account and receiving wallet are active, and at least one selected payment method is enabled by the platform. Renew an expired subscription before accepting new orders. A temporary database error can also prevent the page from loading. The displayed reference code helps support distinguish the cause without exposing credentials.

Which social payment scenarios can I use?

Use separate pages for personal support, creator tips, project support, service fees, pay-what-you-want content, events, community payments or shared expenses. Put the link in a social bio, pinned post or direct message. Suggested setups are optional and editable; they do not restrict your account.

Can I create a personal support page?

Yes. Explain your situation and invite voluntary support toward living costs, study, recovery or a personal goal. Use a free-amount page and an optional supporter message. Share your link in a profile, post or message. Explain the purpose clearly so supporters know what their contribution is for.

How do free, suggested and fixed amounts work?

Free lets the payer choose a crypto quantity. Suggested pre-fills a quantity for one currency and remains editable. Switching currency clears that suggestion. Fixed uses one configured crypto amount and network controlled by the server. The final payable amount can include the existing unique amount adjustment.

Can I collect a project reference or social handle?

Yes. Customize the note label and hint, require a reference when needed, and collect an optional or required email or social handle. Contact details are stored in the private order note; shared page links do not contain buyer order IDs or contact details.

How do I share my page on social media?

Add the permanent page link to your bio or pinned post, send it in a message, or distribute the page QR. Supported phones can use the device share menu; other browsers can copy the link. Each payer has a separate payment order. The shared page QR is different from an order payment QR.

What happens after a social payment is confirmed?

Only a server-confirmed PAID order shows your configured success button. Use it for instructions or contacting the merchant. Merchants arrange service delivery, event admission and community access separately; the page is a single-payment collection flow. The dashboard shows paid order counts and confirmed received amounts by crypto.

06

Chrome Payment Assistant

Install, connect and manage browser payment requests.

What can the Chrome payment assistant do?

Create HPP payment links, copy or display their QR codes, view recent orders and receive optional payment notifications. Open it from Chrome while talking with your customer.

How do I install and connect the assistant?

Download the ZIP, extract it to a fixed folder and load it from chrome://extensions with Developer mode enabled. Generate a code in Merchant Dashboard → Chrome Payment Assistant, then paste it into the extension. Use desktop Chrome 116 or later.

Does the assistant need my API Secret or control my wallet?

No. It uses a revocable connection code for creating and reading payment requests. It cannot send funds or change receiving wallets, and does not read your web pages, messages or browsing history.

Why is my connection code rejected?

A code expires in 10 minutes and can be used once. Generate a fresh code in the merchant dashboard and copy it in full. Update to extension 1.0.1 and reload it if the Connect button stays disabled.

How do browser payment notifications work?

Enable notifications in Settings and allow Chrome's request. While Chrome runs, checks occur about once a minute. Alerts require an observed pending-to-server-confirmed payment change; old paid orders do not trigger alerts. Sleep or offline mode can delay notifications.

Is the Chrome payment assistant free?

The extension is free to install. Creating payment requests requires an active MochiPay subscription and receiving wallet. MochiPay charges a platform subscription fee, with no payment transaction commission.

How do I disconnect or update the assistant?

Disconnect in the extension or revoke access in the merchant dashboard. To update, replace files in the same extension folder and click Reload at chrome://extensions. Keep the folder; existing orders remain available.

07

Affiliate Program

How do I earn money with MochiPay?

Join the affiliate program for free and share your referral link. When a new referred customer makes an eligible subscription payment, you earn 30%. Eligible renewals within 12 months of their first confirmed payment also earn commission. Registrations alone do not earn money. Withdrawals start at 20 USDT on TRON (TRC20).

See earning examples →
Does 12 months mean 12 renewals after the first payment?

No. The commission window starts with the first confirmed subscription payment and ends 12 calendar months later. The monthly example counts 12 payments in total: the first payment plus 11 renewals. Payments at or after the end of the window do not qualify. Commissions are based on your direct referrals only.

See earning examples →
Need more information?

Explore MochiPay resources.

Read the API documentation or connect with the MochiPay community.