Lesson 75: Building the Payment Proof Upload System for Manual Payments
Introduction
In the previous lesson, we enhanced the payment page by providing buyers with professional manual payment instructions, including a unique payment reference number, payment amount, and important payment guidance.
However, after completing a bank transfer or manual payment, buyers still have no way to notify the marketplace that payment has been made.
In this lesson, we will begin building the Payment Proof Upload System. This feature will allow buyers to upload proof of payment directly from the payment page. Although the uploaded proof will not yet be reviewed automatically, this lesson lays the foundation for an administrative verification workflow that will be completed in later lessons.
Why This Feature Matters
For manual payments, marketplace administrators need evidence that payment has actually been made before transferring website ownership.
Typical proof includes:
- Bank transfer receipt
- UPI payment screenshot
- NEFT/RTGS receipt
- Wire transfer confirmation
- Cryptocurrency transaction screenshot
Without an upload facility, buyers would need to send these documents through email, making transaction management much more difficult.
What We Will Build
By the end of this lesson, the payment page will include:
- Upload Proof of Payment section
- Secure file upload field
- Support for common image and PDF formats
- WordPress nonce protection
- Submit Payment Proof button
- Success confirmation message
- Storage of uploaded proof using the WordPress Media Library
- Transaction updated with the uploaded proof attachment ID
Learning Objectives
In this lesson you will learn how to:
- Build secure upload forms in WordPress
- Handle file uploads safely
- Use WordPress Media Library programmatically
- Associate uploaded files with marketplace transactions
- Protect uploads using nonces
- Validate uploaded file types
- Store attachment IDs for later verification
Implementation Roadmap
Step 1
Create the Payment Proof Upload section.
Step 2
Build the upload form.
Step 3
Add WordPress nonce verification.
Step 4
Validate uploaded files.
Step 5
Upload payment proof to the Media Library.
Step 6
Store the attachment ID against the payment transaction.
Step 7
Display upload success confirmation.
Step 8
Prepare the workflow for administrator verification in the next lesson.
Expected Result
The payment page will evolve from this:
Payment Instructions
Reference Number
Amount
Status
Select Payment Method
into:
Payment Instructions
Reference Number
Amount
Status
Upload Payment Proof
Choose File
[ Upload Receipt ]
✓ Payment proof uploaded successfully.
Benefits
After completing this lesson, Flipnzee will gain:
- A complete buyer payment submission workflow
- Secure proof-of-payment uploads
- Organized storage in the WordPress Media Library
- Better transaction tracking
- A foundation for admin payment verification
- Reduced reliance on email communication
What Comes Next?
In Lesson 76, we will build the Administrator Payment Verification Dashboard, allowing administrators to review uploaded payment proofs, approve or reject payments, update transaction statuses, and continue the website ownership transfer workflow. This will complete the first end-to-end manual payment verification cycle within Flipnzee.



