Description
Collect payment receipts from your customers instantly — directly inside WooCommerce orders.
Ainbae Receipt Upload for WooCommerce lets customers upload bank transfer receipts (JPG, PNG, PDF) from their order page, helping you verify payments faster and reduce manual follow-ups.
Why use this plugin?
- No more asking customers for screenshots via email or WhatsApp
- Keep all payment proofs linked directly to orders
- Reduce manual verification work
- Improve customer trust and experience
How it works
- Customer places an order and selects Bank Transfer (BACS) as payment method.
- After placing the order, the receipt upload widget appears on the order detail page.
- Customer uploads a JPG, PNG, or PDF (max 5 MB). The file is stored privately — not in the public media library.
- An order note is added automatically, and the admin can view the receipt securely from the order panel.
- Optionally, a WhatsApp button lets customers send their receipt directly to your WhatsApp number.
Features
- 📤 Upload payment receipts directly from order page
- 📁 Supports JPG, PNG, and PDF files (max 5 MB)
- 🔒 Private storage (not accessible via public media library)
- 🔐 Secure upload with nonce verification
- 👁️ Admin “View Uploaded Receipt” button inside order panel
- 📱 Optional WhatsApp integration for quick sharing
- 🎨 Customizable UI (labels, headings, colors)
Who is this for?
Any WooCommerce store that accepts manual bank transfers and needs a structured, traceable way to collect payment proof from customers. Common use cases include wholesale stores, local businesses, and stores in regions where card payments are less common.
Screenshots
The Admin Setting Page with live widget preview and customisation options. 
The receipt upload widget as seen by the customer on the order received page. 
The receipt upload widget as seen by the customer on the order detail page. 
The confirmation message displayed after a successful upload. 
The confirmation message displayed when order status is changed to processing by admin. 
The “View Uploaded Receipt” button in the WooCommerce order admin panel.
Installation
Automatic installation (recommended)
- In your WordPress admin, go to Plugins Add New.
- Search for Ainbae Receipt Upload for WooCommerce.
- Click Install Now, then Activate.
- Go to WooCommerce Upload Receipt to configure settings.
Manual installation
- Download the plugin zip file.
- Go to Plugins Add New Upload Plugin and upload the zip.
- Activate the plugin.
- Go to WooCommerce Upload Receipt to configure settings.
After activation
- Ensure your store has Bank Transfer (BACS) enabled as a payment method under WooCommerce Settings Payments.
- Enter your WhatsApp number (with country code, digits only) if you want to enable the WhatsApp button.
- Save settings. The upload widget will appear automatically on the order detail page for any pending BACS order.
FAQ
-
Does this work with all payment methods?
-
No — by design. The upload widget only appears for orders paid via Bank Transfer (BACS). It will not show for card, PayPal, or other payment methods.
-
Where are the uploaded files stored?
-
Files are stored in
wp-content/uploads/ainbae-receipt-upload-for-woocommerce/, which is outside the normal media library. A deny-all.htaccessfile blocks direct browser access on Apache servers. -
Does it work on Nginx?
-
The
.htaccessprotection file is Apache-specific and has no effect on Nginx. If your server runs Nginx, you must add a location rule to deny access to theainbae-receipt-upload-for-woocommercedirectory inside uploads. Add this to your Nginx server block:location ~* /uploads/ainbae-receipt-upload-for-woocommerce/ { deny all; }Without this rule, uploaded files on Nginx servers may be directly accessible via URL.
-
What file types are allowed?
-
JPG, JPEG, PNG, and PDF. Maximum file size is 5 MB. These limits are enforced on both the client (HTML
acceptattribute) and the server (wp_handle_uploadMIME validation). -
Can a customer upload more than one receipt?
-
No. Once a receipt has been uploaded for an order, the upload form is replaced with a confirmation message and any further upload attempts are blocked.
-
Can customers delete their uploaded receipt?
-
No. Only an admin with
manage_woocommercecapability can manage uploaded files. -
How does the admin view the receipt?
-
Open any WooCommerce order that has a receipt. A View Uploaded Receipt button appears in the order data panel. Clicking it opens the file in a new tab via a nonce-authenticated, admin-only endpoint.
-
No. You can disable it entirely from the settings page under WooCommerce Upload Receipt.
-
What happens if a customer tries to upload a receipt for someone else’s order?
-
The plugin checks that the logged-in user’s ID matches the order’s customer ID. For guest orders, it validates the order key from the URL. If neither matches, the upload is rejected with a permission error.
-
I activated the plugin but the upload form is not showing. What should I check?
-
- Make sure the order payment method is Bank Transfer (BACS).
- Make sure the order status is Pending Payment or On Hold — the form does not appear for completed, cancelled, processing, or refunded orders.
- Make sure the customer is viewing their own order (logged in, or using a valid order-key link).
- Check that WooCommerce is active and up to date.
Reviews
Contributors & Developers
“Ainbae Receipt Upload for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Ainbae Receipt Upload for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Moved private receipt storage from wp-content root into wp-content/uploads/ainbae-receipt-upload-for-woocommerce/ using wp_upload_dir() per WordPress guidelines
- Replaced WP_CONTENT_DIR constant with wp_upload_dir() for correct path resolution across all WordPress configurations
- Replaced echo of binary file contents with readfile() to stream files without buffering or escaping concerns
- Removed broken donate link from readme.txt
- Updated readme FAQ to reflect new storage path and Nginx configuration instructions
1.0.1
- Fixed security and sanitization issues
- Improved nonce verification
- Minor code improvements for WordPress standards
1.0.0
- Initial release