Melalweb Pay with Bale for WooCommerce
| 开发者 | rezaei1374 |
|---|---|
| 更新时间 | 2026年9月7日 18:43 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Melalweb Pay with Bale adds Bale wallet checkout to WooCommerce using the official Bale Bot payment methods (
sendInvoice, answerPreCheckoutQuery, and inquireTransaction).
Bale no longer supports bot card-to-card money requests. Wallet payment is the supported way for bots to receive money. This plugin can still offer an optional store-managed card-to-card method (destination card + receipt upload) that does not use Bale’s removed bot card-to-card API.
This plugin is an independent Melalweb integration. It is not affiliated with, endorsed by, or officially connected to Bale, WooCommerce, or Automattic. Bale and WooCommerce are trademarks of their respective owners.
Features
- Bale wallet invoices via
sendInvoicewith automatic webhook confirmation - Pre-checkout validation within Bale’s 10-second window (
answerPreCheckoutQuery) - Transaction inquiry via
inquireTransactionwhen a shopper checks payment status - Optional
createInvoiceLinkAPI helper for mini-app style flows - Test wallet token support:
WALLET-TEST-1111111111111111(same flow, no real transfer) - Optional store card-to-card with secure receipt upload and manager review
- Admin dashboard for transactions, linked users, events, and CSV export
- Optional percentage discounts per payment method
- Automatic expiry of unpaid payment requests
- Bundled Persian (
fa_IR) translations for WordPress sites set to فارسی
- The customer signs in and links their account to the Bale bot with a 15-minute one-time code.
- At checkout the plugin creates a payment payload and calls Bale
sendInvoicewith the walletprovider_tokenfrom @botfather. - Bale sends
pre_checkout_query. The plugin re-checks the linked account, amount (IRR), order status, and expiry, then answers withanswerPreCheckoutQuery. - After payment,
successful_paymentis received. The charge ID is stored uniquely and the order is completed. Status checks can also callinquireTransaction.
- WordPress 6.5 or later
- WooCommerce 7.0 or later
- Store currency set to Iranian Rial (IRR) or Toman (IRT / TOMAN)
- A Bale bot token and wallet payment token (
provider_token) from @botfather
fa_IR), the bundled translation in /languages is loaded automatically via load_plugin_textdomain and Domain Path: /languages.
安装:
- Install and activate WooCommerce.
- Upload the plugin ZIP via Plugins → Add New, or copy the
melalweb-pay-with-bale-for-woocommercefolder intowp-content/plugins/. - Activate Melalweb Pay with Bale.
- Set the site language to فارسی if you want the Persian admin and checkout UI.
- Open Melalweb Pay with Bale in the WordPress admin menu.
- Enter the bot username, bot token, and wallet payment token (
provider_token), then save. - Click Register webhook with Bale.
- Optionally enable store card-to-card and add destination cards.
- Set WooCommerce currency to IRR or Toman.
常见问题:
Is this an official Bale or WooCommerce plugin?
No. It is an independent Melalweb plugin that talks to the public Bale Bot API. Melalweb is not affiliated with Bale or WooCommerce.
Does wallet pay support guest checkout?
No. Bale wallet pay needs a logged-in WordPress user linked to a Bale chat. The optional store card-to-card method does support guests.
How do I test payments without transferring money?
Use the Bale test wallet token WALLET-TEST-1111111111111111 as provider_token. It follows the same flow without a real transfer.
Where are receipt files stored?
Receipts are stored privately under uploads/melalweb-balepay-receipts/ and are served only through a capability or order-key check.
Can I keep payment data after uninstalling?
Yes. Tables and settings are kept unless you enable the uninstall option on the Appearance tab.
更新日志:
1.1.0
- Align with current Bale wallet payment docs:
sendInvoice,answerPreCheckoutQuery,inquireTransaction, andcreateInvoiceLink. - Store PreCheckoutQuery ID and use
inquireTransactionwhen shoppers check payment status. - Document wallet payment token from @botfather and the official test token.
- Clarify that Bale bot card-to-card money requests are discontinued; keep optional store card-to-card as a separate feature (disabled by default for new installs).
- Add WordPress.org-standard i18n:
Domain Path,load_plugin_textdomain, and bundledfa_IRtranslations.
- WordPress.org review updates: display name and slug, prefixes, nonce on receipt viewing, and Bale service disclosure.
- Initial release.