{"id":303369,"date":"2026-05-06T12:35:21","date_gmt":"2026-05-06T12:35:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ainbae-receipt-upload-for-woocommerce\/"},"modified":"2026-06-22T19:59:12","modified_gmt":"2026-06-22T19:59:12","slug":"ainbae-receipt-upload-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/ja.wordpress.org\/plugins\/ainbae-receipt-upload-for-woocommerce\/","author":23485377,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.0","stable_tag":"2.1.0","tested":"7.0","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Ainbae Receipt Upload for WooCommerce","header_author":"Ainbae","header_description":"Allows customers to upload bank transfer receipts on the order detail page.","assets_banners_color":"f5f9fb","last_updated":"2026-06-22 19:59:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/www.ainbae.com","rating":5,"author_block_rating":0,"active_installs":40,"downloads":563,"num_ratings":1,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"ainbae","date":"2026-05-10 12:33:52"},"1.0.3":{"tag":"1.0.3","author":"ainbae","date":"2026-05-21 14:37:36"},"1.2.0":{"tag":"1.2.0","author":"ainbae","date":"2026-05-29 19:26:09"},"2.0.0":{"tag":"2.0.0","author":"ainbae","date":"2026-06-20 18:28:00"},"2.1.0":{"tag":"2.1.0","author":"ainbae","date":"2026-06-22 19:59:12"}},"upgrade_notice":{"2.1.0":"

Introduces a brand-new tabbed admin dashboard, making plugin settings easier to navigate, manage, and customize. Existing settings remain fully compatible after updating.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-256x256.gif":{"filename":"icon-256x256.gif","revision":3524418,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3527771,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3527771,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.2.0","2.0.0","2.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3582332,"resolution":"1","location":"assets","locale":"","width":2700,"height":1490},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3582332,"resolution":"10","location":"assets","locale":"","width":2700,"height":1490},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3582332,"resolution":"2","location":"assets","locale":"","width":2700,"height":1490},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3582332,"resolution":"3","location":"assets","locale":"","width":2700,"height":1490},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3582332,"resolution":"4","location":"assets","locale":"","width":2700,"height":1490},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3582332,"resolution":"5","location":"assets","locale":"","width":2700,"height":1490},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3582332,"resolution":"6","location":"assets","locale":"","width":2700,"height":1490},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3582332,"resolution":"7","location":"assets","locale":"","width":2700,"height":1490},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3582332,"resolution":"8","location":"assets","locale":"","width":2700,"height":1490},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3582332,"resolution":"9","location":"assets","locale":"","width":2700,"height":1490}},"screenshots":{"1":"The Admin Setting Page with live widget preview and customisation options.","2":"Customize the widget colours and layout to match your store branding and check live preview.","3":"Customize the WhatsApp message template with dynamic variables for a personalized customer experience.","4":"Require Receipt Before Order Placement toggle. If enabled, customers who select Direct Bank Transfer (BACS) must upload their receipt before the order is created. An upload modal appears when they click \"Place Order\". This setting is disabled by default.","5":"The receipt upload modal appears during checkout if \"Require Receipt Before Order Placement\" is enabled in settings. Customers can drag-and-drop or select their receipt file, and a progress indicator shows the upload status.","6":"The receipt upload widget as seen by the customer on the order received or thank you page.","7":"The receipt upload widget as seen by the customer on the order detail page.","8":"The confirmation message displayed after a successful upload.","9":"The confirmation message displayed when order status is changed to processing by admin.","10":"The \"View Uploaded Receipt\" button in the WooCommerce order admin panel."}},"plugin_section":[],"plugin_tags":[127760,262021,262020,26349,286],"plugin_category":[45],"plugin_contributors":[262022],"plugin_business_model":[],"class_list":["post-303369","plugin","type-plugin","status-publish","hentry","plugin_tags-bank-transfer","plugin_tags-payment-receipt","plugin_tags-payment-verification","plugin_tags-receipt","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-ainbae","plugin_committers-ainbae","plugin_support_reps-basitaminbhatti"],"banners":{"banner":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/banner-772x250.png?rev=3527771","banner_2x":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/banner-1544x500.png?rev=3527771","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/icon-256x256.gif?rev=3524418","icon_2x":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/icon-256x256.gif?rev=3524418","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-1.png?rev=3582332","caption":"The Admin Setting Page with live widget preview and customisation options."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-2.png?rev=3582332","caption":"Customize the widget colours and layout to match your store branding and check live preview."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-3.png?rev=3582332","caption":"Customize the WhatsApp message template with dynamic variables for a personalized customer experience."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-4.png?rev=3582332","caption":"Require Receipt Before Order Placement toggle. If enabled, customers who select Direct Bank Transfer (BACS) must upload their receipt before the order is created. An upload modal appears when they click \"Place Order\". This setting is disabled by default."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-5.png?rev=3582332","caption":"The receipt upload modal appears during checkout if \"Require Receipt Before Order Placement\" is enabled in settings. Customers can drag-and-drop or select their receipt file, and a progress indicator shows the upload status."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-6.png?rev=3582332","caption":"The receipt upload widget as seen by the customer on the order received or thank you page."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-7.png?rev=3582332","caption":"The receipt upload widget as seen by the customer on the order detail page."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-8.png?rev=3582332","caption":"The confirmation message displayed after a successful upload."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-9.png?rev=3582332","caption":"The confirmation message displayed when order status is changed to processing by admin."},{"src":"https:\/\/ps.w.org\/ainbae-receipt-upload-for-woocommerce\/assets\/screenshot-10.png?rev=3582332","caption":"The \"View Uploaded Receipt\" button in the WooCommerce order admin panel."}],"raw_content":"\n

Ainbae Receipt Upload for WooCommerce<\/strong> adds a secure upload widget to the customer-facing order detail page. When a customer pays via bank transfer (BACS), they can immediately upload a screenshot or PDF of their payment receipt, no emails, no support tickets, no guesswork.<\/p>\n\n

You get a clean, nonce-protected upload flow. Your customer gets instant confirmation. Your admin team gets a one-click \"View Uploaded Receipt\" button inside the WooCommerce order panel.<\/p>\n\n

How it works<\/h4>\n\n
    \n
  1. Customer places an order and selects Bank Transfer (BACS) as payment method.<\/li>\n
  2. After placing the order, the receipt upload widget appears on the order detail page.<\/li>\n
  3. Customer uploads a JPG, PNG, or PDF (max 5 MB). The file is stored privately, not in the public media library.<\/li>\n
  4. An order note is added automatically, and the admin can view the receipt securely from the order panel.<\/li>\n
  5. Optionally, a WhatsApp button lets customers send their receipt directly to your WhatsApp number.<\/li>\n
  6. Optionally, For stores that want to enforce receipt uploads before order placement, the plugin can be configured to require a receipt upload before the order is created (BACS only).<\/li>\n<\/ol>\n\n

    Features<\/h3>\n\n
      \n
    • Upload receipt from order page<\/li>\n
    • Drag-and-drop upload with progress bar<\/li>\n
    • Supports JPG, PNG, PDF<\/li>\n
    • Admin can view receipts securely<\/li>\n
    • WhatsApp integration with customisable message templates<\/li>\n
    • Require receipt before order placement (optional)<\/li>\n
    • Improved admin receipt detection with automatic metadata recovery<\/li>\n
    • Customizable UI<\/li>\n<\/ul>\n\n

      Who is this for?<\/h4>\n\n

      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.<\/p>\n\n\n

      Automatic installation (recommended)<\/strong>\n1. In your WordPress admin, go to Plugins \u2192 Add New<\/strong>.\n2. Search for Ainbae Receipt Upload for WooCommerce<\/em>.\n3. Click Install Now<\/strong>, then Activate<\/strong>.\n4. Go to WooCommerce \u2192 Upload Receipt<\/strong> to configure settings.<\/p>\n\n

      Manual installation<\/strong>\n1. Download the plugin zip file.\n2. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong> and upload the zip.\n3. Activate the plugin.\n4. Go to WooCommerce \u2192 Upload Receipt<\/strong> to configure settings.<\/p>\n\n

      After activation<\/strong>\n* Ensure your store has Bank Transfer (BACS)<\/strong> enabled as a payment method under WooCommerce \u2192 Settings \u2192 Payments<\/strong>.\n* Enter your WhatsApp number (with country code, digits only) if you want to enable the WhatsApp button.\n* Save settings. The upload widget will appear automatically on the order detail page for any pending BACS order.<\/p>\n\n\n

      \n

      Does this work with all payment methods?<\/h3><\/dt>\n

      No \u2014 by design. The upload widget only appears for orders paid via Bank Transfer (BACS)<\/strong>. It will not show for card, PayPal, or other payment methods.<\/p><\/dd>\n

      Where are the uploaded files stored?<\/h3><\/dt>\n

      Files are stored in wp-content\/uploads\/ainbae-receipt-upload-for-woocommerce\/<\/code>, which is outside the normal media library. A deny-all .htaccess<\/code> file blocks direct browser access on Apache servers.<\/p><\/dd>\n

      Does it work on Nginx?<\/h3><\/dt>\n

      The .htaccess<\/code> protection file is Apache-specific and has no effect on Nginx<\/strong>. If your server runs Nginx, you must add a location rule to deny access to the ainbae-receipt-upload-for-woocommerce<\/code> directory inside uploads. Add this to your Nginx server block:<\/p>\n\n

      location ~* \/uploads\/ainbae-receipt-upload-for-woocommerce\/ { deny all; }\n<\/code><\/pre>\n\n
      Without this rule, uploaded files on Nginx servers may be directly accessible via URL.<\/p><\/dd>\n
      What file types are allowed?<\/h3><\/dt>\n
      JPG, JPEG, PNG, and PDF. Maximum file size is 5 MB. These limits are enforced on both the client (HTML accept<\/code> attribute) and the server (wp_handle_upload<\/code> MIME validation).<\/p><\/dd>\n
      Can a customer upload more than one receipt?<\/h3><\/dt>\n
      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.<\/p><\/dd>\n
      Can customers delete their uploaded receipt?<\/h3><\/dt>\n
      No. Only an admin with manage_woocommerce<\/code> capability can manage uploaded files.<\/p><\/dd>\n
      How does the admin view the receipt?<\/h3><\/dt>\n
      Open any WooCommerce order that has a receipt. A View Uploaded Receipt<\/strong> button appears in the order data panel. Clicking it opens the file in a new tab via a nonce-authenticated, admin-only endpoint.<\/p><\/dd>\n
      Is the WhatsApp button required?<\/h3><\/dt>\n
      No. You can disable it entirely from the settings page under WooCommerce \u2192 Upload Receipt<\/strong>.<\/p><\/dd>\n
      What happens if a customer tries to upload a receipt for someone else's order?<\/h3><\/dt>\n
      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.<\/p><\/dd>\n
      I activated the plugin but the upload form is not showing. What should I check?<\/h3><\/dt>\n
        \n
      1. Make sure the order payment method is Bank Transfer (BACS)<\/strong>.<\/li>\n
      2. Make sure the order status is Pending Payment<\/strong> or On Hold<\/strong> \u2014 the form does not appear for completed, cancelled, processing, or refunded orders.<\/li>\n
      3. Make sure the customer is viewing their own order (logged in, or using a valid order-key link).<\/li>\n
      4. Check that WooCommerce is active and up to date.<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n\n
        2.1.0<\/h4>\n\n
          \n
        • New: Added a completely redesigned admin dashboard interface.<\/li>\n
        • New: Introduced a tabbed settings layout for easier navigation.<\/li>\n
        • New: Added dedicated tabs for:\n\n
            \n
          • General Settings (WhatsApp, Require Receipt Before Order Placement Option)<\/li>\n
          • Text & Labels (customize all user-facing text)<\/li>\n
          • Colour Settings (customize colours for each element of the upload widget)<\/li>\n
          • Layout Settings (customize the border radius of the upload widget)<\/li>\n<\/ul><\/li>\n
          • New: Added a modern settings header with branding and welcome section.<\/li>\n
          • New: Added sticky \"Save Changes\" footer for quicker configuration management.<\/li>\n
          • New: Added improved settings sections with clearer grouping and descriptions.<\/li>\n
          • New: Added a warning banner if Direct Bank Transfer (BACS) is not enabled in WooCommerce settings.<\/li>\n
          • Fix: Default whatsapp message template now correctly spaced.<\/li>\n
          • Improvement: Improved dashboard usability and navigation.<\/li>\n
          • Improvement: Improved settings organization by separating options into dedicated sections.<\/li>\n<\/ul>\n\n
            2.0.0<\/h4>\n\n
              \n
            • New: Custom WhatsApp message template with dynamic variable support ({order_number}, {order_total}, {customer_name}, {billing_email}, {billing_phone}, {site_name}, {currency}, {order_date})<\/li>\n
            • New: \"Require Receipt Before Order Placement\" checkout feature \u2014 BACS customers must upload receipt before order is created (optional, disabled by default)<\/li>\n
            • New: Checkout upload modal with drag-and-drop, progress bar, and accessibility support<\/li>\n
            • Fix: Admin panel now correctly detects receipts using a 5-priority system \u2014 prevents false \"No receipt uploaded yet\" messages<\/li>\n
            • New: Automatic metadata recovery system \u2014 rebuilds broken receipt meta if the physical file still exists<\/li>\n
            • New: Centralized AINBAE_BACS_VERSION constant for all asset enqueue calls<\/li>\n
            • New: Debug logging for upload failures, recovery events, and missing metadata (WP_DEBUG_LOG gated)<\/li>\n
            • Backward compatible \u2014 all existing uploads, settings, and workflows continue to work unchanged<\/li>\n<\/ul>\n\n
              1.2.0<\/h4>\n\n
                \n
              • Fixed Setting Page WhatsApp number field prefix input styling<\/li>\n
              • Added languages directory and translation files<\/li>\n
              • Updated tested up to version to 10.8.1 (WooCommerce)<\/li>\n
              • Updated stable tag to 1.2.0 for latest release<\/li>\n<\/ul>\n\n
                1.0.3<\/h4>\n\n
                  \n
                • Updated tested up to version to 7.0<\/li>\n
                • Updated stable tag to 1.0.3 for latest release<\/li>\n<\/ul>\n\n
                  1.0.2<\/h4>\n\n
                    \n
                  • Moved private receipt storage from wp-content root into wp-content\/uploads\/ainbae-receipt-upload-for-woocommerce\/ using wp_upload_dir() per WordPress guidelines<\/li>\n
                  • Replaced WP_CONTENT_DIR constant with wp_upload_dir() for correct path resolution across all WordPress configurations<\/li>\n
                  • Replaced echo of binary file contents with readfile() to stream files without buffering or escaping concerns<\/li>\n
                  • Removed broken donate link from readme.txt<\/li>\n
                  • Updated readme FAQ to reflect new storage path and Nginx configuration instructions<\/li>\n<\/ul>\n\n
                    1.0.1<\/h4>\n\n
                      \n
                    • Fixed security and sanitization issues<\/li>\n
                    • Improved nonce verification<\/li>\n
                    • Minor code improvements for WordPress standards<\/li>\n<\/ul>\n\n
                      1.0.0<\/h4>\n\n
                        \n
                      • Initial release<\/li>\n<\/ul>","raw_excerpt":"Allow customers to upload bank transfer receipts directly from the WooCommerce order details page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/303369","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=303369"}],"author":[{"embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ainbae"}],"wp:attachment":[{"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=303369"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=303369"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=303369"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=303369"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=303369"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ja.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=303369"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}