WordPress.org
Get WordPress

Plugin Directory

Changeset 3735348


Ignore:
Timestamp:
10/08/2026 06:37:50 PM (2 weeks ago)
Author:
bitquintet
Message:

0.1.0

Location:
qrpaybd-payments
Files:
73 added
1 deleted
1 edited

Legend:

Unmodified
Added
Removed

  • qrpaybd-payments/trunk/readme.txt

    r3719561 r3735348  
    11=== QRPayBD Payments ===
    22Contributors: bitquintet
    3 Tags: payments, woocommerce, elementor, bangladesh, qr code
     3Tags: payments, woocommerce, elementor, bangladesh, bkash
    44Requires at least: 6.0
    55Tested up to: 7.1
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Accept Bangladeshi wallet and Bangla QR payments confirmed from your own phone's payment SMS. WooCommerce gateway and Elementor Pay Button.
     11Confirm bKash, Nagad and Upay wallet payments automatically from your own phone's payment SMS. WooCommerce gateway and Elementor Pay Button.
    1212
    1313== Description ==
    1414
    15 QRPayBD confirms Bangladeshi mobile wallet and Bangla QR payments by reading the "payment received" SMS on an Android phone that you own. This plugin connects your WordPress site to **your own QRPayBD server**:
     15[QRPayBD](https://qrpaybd.com/) confirms payments to your personal bKash, Nagad or Upay wallet number by reading the "payment received" SMS on an Android phone that you own. This plugin connects your WordPress site to **your own QRPayBD account**:
    1616
    17 1. Your site creates an order at QRPayBD and sends the customer to the QRPayBD-hosted payment page.
    18 2. The customer scans your shop's QR in their wallet or banking app, pays the exact amount and enters the TrxID from their payment SMS.
    19 3. QRPayBD checks the TrxID and amount against the SMS on your phone and marks the order paid.
     171. Your site creates an order at QRPayBD and sends the customer to the QRPayBD-hosted payment page. It shows your wallet number, the exact amount and an order reference.
     182. The customer sends the exact amount to your number with Send Money in their wallet app. If the app has a Reference field they type the order reference there, and the order can confirm by itself. Otherwise they enter the TrxID from their payment SMS on the payment page.
     193. QRPayBD checks the reference or TrxID and the amount against the SMS on your phone and marks the order paid.
    20204. QRPayBD sends your site a signed webhook and your order is completed. QRPayBD never holds your money.
     21
     22**What it supports.** The message readers for bKash, Nagad and Upay have been verified on real payments. Rocket and banks are planned. Official merchant APIs of the wallet providers are not supported yet. This is not an official wallet or bank API: messages can be delayed, missed, reworded or forged, so check your wallet balance for large orders.
     23
     24**Personal wallet numbers.** Wallet providers may restrict business use of personal accounts in their own terms. You are responsible for reading and following the current terms of your provider.
     25
     26**Before you start.** You need a free QRPayBD account at [qrpaybd.com](https://qrpaybd.com/) (free during early access) and the QRPayBD Collector app on the Android phone that receives your payment SMS. Download the app and read the guides at [qrpaybd.com/download](https://qrpaybd.com/download/) and [qrpaybd.com/docs](https://qrpaybd.com/docs/).
    2127
    2228**Not affiliated.** bKash, Nagad, Upay and Rocket are trademarks of their respective owners. This plugin is not affiliated with, endorsed by or sponsored by any of them; they are named only to describe payment services your customers may already use.
    … …  
    5157What is sent, and when:
    5258
    53 * **Creating a payment** (a customer chooses the QRPayBD payment method at checkout, or a visitor clicks a QRPayBD Pay Button): the order total in taka, a store order id (`wc-<site hash>-<order number>` or `el-<page id>-<widget id>-<random>`), and a return URL (the WooCommerce order-received page, or the page holding the button). Your store API key is sent in the `Authorization` header. The plugin sends no customer name, email address, phone number or address. The customer's browser is then redirected to the QRPayBD-hosted payment page, where the customer enters the TrxID from their payment SMS; that page is operated by the QRPayBD server.
     59* **Creating a payment** (a customer chooses the QRPayBD payment method at checkout, or a visitor clicks a QRPayBD Pay Button): the order total in taka, a store order id (`wc-<site hash>-<order number>` or `el-<page id>-<widget id>-<random>`), and a return URL (the WooCommerce order-received page, or the page holding the button). Your store API key is sent in the `Authorization` header. The plugin sends no customer name, email address, phone number or address. The customer's browser is then redirected to the QRPayBD-hosted payment page, where the customer sees your wallet number, the exact amount and the order reference, and enters the TrxID from their payment SMS if needed; that page is operated by the QRPayBD server.
    5460* **Checking a payment**: the QRPayBD order id and your API key, every five minutes for unpaid orders younger than 48 hours, once when the customer returns to the order-received page, and when an administrator presses "Re-check now".
    5561* **Cancelling a payment**: the QRPayBD order id and your API key, when a WooCommerce order is cancelled while its payment is unpaid.
    … …  
    6470== Installation ==
    6571
    66 1. Upload the `qrpaybd-payments` folder to `/wp-content/plugins/`, or install the zip through Plugins > Add New > Upload Plugin, then activate it.
    67 2. Go to **Settings > QRPayBD** (or WooCommerce > Settings > Payments > QRPayBD) and enter:
     721. Create a QRPayBD account at https://qrpaybd.com/, add your wallet number as a payment method, and install and pair the Collector app on your shop phone (see https://qrpaybd.com/download/).
     732. Upload the `qrpaybd-payments` folder to `/wp-content/plugins/`, or install the zip through Plugins > Add New > Upload Plugin, then activate it.
     743. Go to **Settings > QRPayBD** (or WooCommerce > Settings > Payments > QRPayBD) and enter:
    6875   * **QRPayBD base URL**: must start with `https://`. Plain `http://` is only accepted for `localhost` or `127.0.0.1`.
    6976   * **Store API key**: create it in your QRPayBD dashboard (Store setup).
    7077   * **Webhook secret**: shown in the QRPayBD dashboard next to the webhook URL.
    71 3. Copy the **Webhook URL** shown on the settings page (`https://your-site/wp-json/qrpaybd/v1/webhook`) into the webhook setting of your QRPayBD dashboard. In production QRPayBD requires a public https address.
    72 4. Press **Test connection**. It checks that the server answers and that the key is accepted. The key is never displayed.
    73 5. WooCommerce: enable the QRPayBD method under WooCommerce > Settings > Payments and set the store currency to BDT.
    74 6. Elementor: drag **QRPayBD Pay Button** (QRPayBD category) into a page, set the amount and update the page.
     784. Copy the **Webhook URL** shown on the settings page (`https://your-site/wp-json/qrpaybd/v1/webhook`) into the webhook setting of your QRPayBD dashboard. In production QRPayBD requires a public https address.
     795. Press **Test connection**. It checks that the server answers and that the key is accepted. The key is never displayed.
     806. WooCommerce: enable the QRPayBD method under WooCommerce > Settings > Payments and set the store currency to BDT.
     817. Elementor: drag **QRPayBD Pay Button** (QRPayBD category) into a page, set the amount and update the page.
    7582
    7683Both WooCommerce and Elementor are optional. Each part loads only when its plugin is active. With neither active the plugin loads harmlessly and shows a dismissible notice explaining what each part needs.
    … …  
    8087= Is this an official wallet or bank API? =
    8188
    82 No. QRPayBD reads the payment SMS on your own Android phone with a collector app and matches the customer's TrxID and the exact amount. It is not an official wallet or bank API, the SMS wording of a wallet can change, and a forged SMS combined with a matching TrxID is a residual risk. Review unusual orders and use the optional balance check offered by QRPayBD.
     89No. QRPayBD reads the payment SMS on your own Android phone with a collector app and matches the order reference or the customer's TrxID and the exact amount. It is not an official wallet or bank API, the SMS wording of a wallet can change, and a forged SMS combined with a matching TrxID is a residual risk. Review unusual orders and use the optional balance check offered by QRPayBD.
     90
     91= Which wallets are supported? =
     92
     93bKash, Nagad and Upay personal wallet numbers (Send Money). The message readers for these three have been verified on real payments. Rocket and banks are planned. Official merchant APIs of the providers are planned and not available yet.
     94
     95= Can I use a personal wallet number for my shop? =
     96
     97QRPayBD is built for personal wallet numbers, but wallet providers may restrict business use of personal accounts in their own terms. Check your provider's current terms before you rely on it. QRPayBD is not affiliated with any provider and cannot give you permission.
    8398
    8499= Which phones and currencies work? =
Note: See TracChangeset for help on using the changeset viewer.