
Closed
Posted
Paid on delivery
Project Brief — Auto-Apply Member Discounts via Payment Cards (Square for Retail) Objective When a customer pays in Square for Retail, automatically detect membership by matching the payment card fingerprint (including Apple/Google Pay) to your membership records, then apply the correct discount with no staff action. Support multiple cards per membership (e.g., family plans). ________________________________________ Scope (MVP) • Works on Square for Retail (iPad, Register, Terminal with Retail). • Detects membership from [login to view URL] (or equivalent) received via Square APIs/Webhooks. • Applies one of: o Pre-payment discount injection (preferred) by updating the open order, or o Immediate post-payment adjustment (partial refund or discount line via order update). • Membership types: individual, family (n cards → 1 membership), staff/other tiers. • Admin portal for enrollment, card linking, membership management, and logs. ________________________________________ High-Level Flow Enrollment 1. Staff creates/locates a Square Customer profile. 2. Each member performs a low-value “registration” charge (e.g., £0.01) or a normal purchase. 3. Backend listens to [login to view URL] webhook → reads card fingerprint. 4. Store mapping: fingerprint → membership_id (many fingerprints can map to one membership). 5. For family: repeat step 2–4 for each person/card; all map to the same membership. Checkout (Operational) 1. Staff rings items in Square for Retail as usual. 2. Customer taps/inserts card or mobile wallet. 3. [login to view URL] webhook fires to middleware with card fingerprint + order/payment IDs. 4. Middleware: o Looks up fingerprint → membership (and tier/expiry). o If eligible: Preferred: call Orders API to attach a configured “Membership Discount” to the open order (or immediately update the just-created order then re-sync). Fallback: issue an instant partial refund equal to discount value; add an audit note. 5. Receipt shows discount line (preferred) or refund line (fallback). ________________________________________ Square APIs & Events (use latest) • Webhooks: [login to view URL] (primary), optionally [login to view URL] and order.updated. • Payments API: read payment data to obtain [login to view URL], order_id, amounts. • Customers API: manage customer profiles and optional linking. • Cards API (on file): optional for storing cards to a customer; not required to read fingerprint at checkout. • Orders API: attach discounts (catalog-configured or ad-hoc) to the order. • Catalog API: pre-create standard discount objects (e.g., “Member 10%”, “Family 15%”). Note: Final approach depends on the exact timing Square allows for order mutations around Retail checkout. Implement both pre-finalization update and post-payment refund paths; pick automatically based on state. ________________________________________ Data Model (Backend) Tables/Collections (suggested): • memberships o id, type (individual/family/staff), status (active/suspended/expired), start_at, end_at, discount_rule_id, square_customer_id (nullable) • member_identities o id, membership_id, name, email/phone (optional), notes • payment_fingerprints o id, membership_id, fingerprint (unique index), added_at, label (“Mum iPhone”, “Dad physical card”) • discount_rules o id, name, mode (percent/fixed), value, max_per_order, eligible_categories (optional), eligible_locations • events_audit o id, ts, type (enrolment/match/applied/refund/error), payload_ref, user/context Key constraints: • 1..N payment_fingerprints → 1 membership (supports families). • Fingerprint must be unique across system. ________________________________________ Discount Logic • If multiple active memberships match (edge case), resolve by priority: explicit customer link > most specific tier > latest expiry. • Apply one discount per order by default. (Configurable: allow stacking with promo codes?) • Optional rules: o Category restrictions (e.g., exclude gift cards). o Max discount per order. o Location-specific eligibility. ________________________________________ Admin/Ops Requirements • Web portal (role-based) to: o Create/renew/suspend memberships. o Add/remove fingerprints (by listening for next payment and “claiming” it). o View recent taps/matches, discount applications, and errors. o Export CSV logs. • “Claim next payment” workflow for easy card enrollment at the till. ________________________________________ Edge Cases & Handling • New/replaced card or new phone wallet: fingerprint changes → prompt staff to re-enroll via “claim next payment”. • Declined payment: ignore. • Refunds/voids: log; optionally revoke earned perks (if you add loyalty later). • Multiple partial payments: apply discount to the order total once. • Offline mode: queue webhook processing and reconcile when online. • Concurrency: idempotency keys on order updates/refunds. ________________________________________ Security & Compliance • Store only Square fingerprints, never PANs. • Encrypt at rest and in transit; rotate secrets. • Principle of least privilege on Square tokens; per-env credentials. • GDPR: document lawful basis (contract/legitimate interest), data retention, and deletion workflow. • Full audit trail of discount decisions. ________________________________________ Performance Targets • Time from [login to view URL] to discount/refund action: ≤ 2 seconds p95. • Observability: structured logs + metrics (match rate, avg latency, error rate). ________________________________________ Testing Plan • Sandbox with test cards/wallets; simulate payment.created. • Unit tests for match/discount logic. • Integration tests for both order-update and refund paths. • UAT in a low-traffic store at opening/closing times. • Rollout guard: feature flag by location + percentage of orders. ________________________________________ Deliverables 1. Middleware service (containerised) with documented env vars and Helm/Docker Compose. 2. Admin portal (auth, RBAC) for memberships and logs. 3. Square Catalog setup scripts for discount items. 4. Webhook receiver with verification & retries. 5. Documentation: architecture, runbooks, API keys, onboarding steps. 6. Training one-pager for staff (“How family memberships work at checkout”). 7. Post-deploy monitoring dashboard. ________________________________________ Acceptance Criteria • Individual & family memberships both apply the correct discount automatically in Square for Retail. • Multiple fingerprints can be linked to one membership; any of them triggers the discount. • Receipts show the discount line (preferred path) or net total after instant refund (fallback). • Match success rate ≥ 98% for enrolled members; false-positive rate ~0%. • End-to-end latency ≤ 2s p95. ________________________________________ Tech Stack (suggested) • Backend: Node.js (TypeScript) or Python (FastAPI). • DB: PostgreSQL. • Infra: AWS Fargate/Lambda (or GCP/Azure), with HTTPS and WAF. • Auth: OAuth for Square; JWT for admin. • Observability: OpenTelemetry + CloudWatch/Stackdriver. ________________________________________ Nice-to-Haves (Phase 2) • Optional tie-in to Square Customers so matched orders auto-associate the customer profile. • Member portal for self-service card re-enrollment (“make a £0.01 verification purchase to add your new phone”). • Hybrid logic to also accept QR/Barcode (for edge devices or gift purchases). ________________________________________ Non-Goals • Reading raw NFC tag UIDs from Square hardware (not supported). • Altering Square payment flows beyond APIs/webhooks.
Project ID: 39690365
46 proposals
Remote project
Active 9 mos ago
Set your budget and timeframe
Get paid for your work
Outline your proposal
It's free to sign up and bid on jobs
46 freelancers are bidding on average £150 GBP for this job

Hello gordonb7, I went through your project description and it seems like a perfect fit for my expertise. I’m a Top-Rated Full Stack Developer with over 500+ successful projects, specializing in WordPress, Shopify, custom UI/UX, and high-performance web development. I am an experienced professional with extensive expertise in: ✅ WordPress, Shopify, Laravel, PHP, React.js, Vue.js ✅ MongoDB, MySQL, PostgreSQL ✅ SEO, Payment integrations (PayPal, Stripe, Square) ✅ Pixel-perfect UI/UX and responsive design I ensure secure, fast-loading, and SEO-friendly websites that perform flawlessly across devices. Please come over chat and discuss your requirements in more detail. I also offer: ✅ 1-month free support after delivery ✅ FREE basic SEO setup ✅ Security and backup configuration included Regards, Kausar Parveen Multimedia Graphic Designer & Full-Stack Developer Your Partner in Digital Excellence
£180 GBP in 3 days
8.3
8.3

Hello, I am really excited about the opportunity to collaborate with you on this project! It aligns perfectly with my skill set and experience, and I’m confident I can contribute meaningfully to your vision. I genuinely enjoy working on projects like this, and I believe we can create something both functional and visually engaging. Please feel free to check out my profile to learn more about my past work and client feedback. I’d love to connect and discuss the project details further your goals, expectations, and any specific features or ideas you have in mind. The more I understand your vision, the better I can bring it to life. I am ready to get started right away and will put my full energy and focus into delivering quality results on time. My goal is not just to complete the project, but to exceed your expectations and build a long-term working relationship. Looking forward to hearing from you soon! With regards! Divya
£250 GBP in 7 days
8.1
8.1

Hello Gordon, I hope this proposal finds you well and excited about the Square POS System Setup project brief you've shared. I've carefully reviewed the objectives and scope of the project, and I'm confident in my ability to deliver the required functionalities. I propose to develop a comprehensive system that auto-applies member discounts via payment cards on Square for Retail. The system will seamlessly detect membership through payment card fingerprints, support various membership types, and include an admin portal for enrollment and management. The high-level flow involves staff creating Square customer profiles, registering members, detecting fingerprints, mapping to memberships, and applying discounts during checkout. The system will utilize Square APIs like webhooks, Payments API, Customers API, and Orders API for seamless integration. The backend data model will include tables for memberships, member identities, payment fingerprints, discount rules, and events audit to ensure smooth operations and tracking. For the discount logic, the system will prioritize active memberships, apply one discount per order by default, and support optional rules like category restrictions and max discounts. The admin/ops requirements will be fulfilled with a role-based web portal for membership management, fingerprint linking, viewing logs, and exporting CSV logs. I suggest a budget range of £250 - £400 for the project, with a duration of 15 - 20 days for completion. I look forwa
£160 GBP in 29 days
7.0
7.0

Hello, Thank you so much for posting this opportunity it sounds like a great fit, and I’d love to be part of it! I’ve worked on similar projects before, and I’m confident I can bring real value to your project. I’m passionate about what I do and always aim to deliver work that’s not only high-quality but also makes things easier and smoother for my clients. Feel free to take a quick look at my profile to see some of the work I’ve done in the past. If it feels like a good match, I’d be happy to chat further about your project and how I can help bring it to life. I’m available to get started right away and will give this project my full attention from day one. Let’s connect and see how we can make this a success together! Looking forward to hearing from you soon. With Regards! Abhishek Saini
£250 GBP in 7 days
6.6
6.6

With a project of this complexity and significance, you'll be needing someone with a deep, diverse skill set and plenty of experience - luckily that's where I come in. With over 7 years of API Development and Integration, among other things, I have built customized software solutions for a wide array of businesses-from startups to enterprises. I am particularly proficient in languages such as C#, PHP and Node.js, which are instrumental for this project. Moreover, I possess extensive experience in managing and synchronizing databases smartly, like MySQL. Furthermore, the scope of your project entails not just technical knowledge but also excellent problem-solving skills and attention to detail. You'll be pleased to know that these attributes define my development process. My team at Adnan Technologies has delivered several successful projects on tight timelines with zero errors. Quality is important, and that's why we subject any solution to rigorous testing before deployment. This ensures smooth operations with minimum disruptions.
£135 GBP in 7 days
6.5
6.5

Hello, Hope you're doing great. I have extensive experience building scalable, secure backend systems with Node.js and Python FastAPI, and I am confident I can deliver your membership discount automation for Square for Retail flawlessly. I will develop a middleware service to detect membership via card fingerprints, apply discounts through the Orders API or issue instant refunds as a fallback, and build a role-based admin portal for enrollment and management. The system will support multiple cards per membership (family plans), with strict logging, audit trails, and GDPR compliance. My approach prioritizes low latency (under 2 seconds), high match accuracy, and robust error handling. I am ready to provide thorough documentation, staff training materials, and monitoring dashboards. I have 4 years of experience in Website Development, Graphic Design, Website Design, Logo Design, WordPress, HTML, CSS, PHP, Full Stack Development, Website customization, theme customization, and API integrations. Let’s connect to discuss your vision—I’d love to bring this recruitment piece to life and help attract the next generation of firefighter/paramedics. Feel free to message me to get started! Regards, Adnan H.
£135 GBP in 5 days
6.4
6.4

Hi, With a comprehensive understanding of Square for Retail and extensive experience in developing complex, high-volume systems using C#, MySQL, Node.js, PHP and Software Development, I am uniquely positioned to spearhead your Square POS System Setup project. The task at hand, which involves automating the application of member discounts by matching payment card fingerprints to membership records, aligns perfectly with the background I bring to the table. Over the years, I have successfully designed and implemented a range of payment processing systems that include an array of complex business rules like yours. To ensure an effective approach to this project, I will utilize my proficiency in incorporating webhooks, working with Square APIs such as Payments API and Customers API as well as utilizing Tables/Collections for data management. My solutions are not only crafted with a focus on seamless automation but also on scalability and sustainability. I'm cognizant of the dynamic nature of your business and will design the system in a flexible way that allows for future changes in discount logic or stacking promo codes as required.
£135 GBP in 3 days
6.2
6.2

Hello, I’m Karthik, a backend developer with 10+ years of experience specializing in Node.js and complex API integrations. I have deep expertise in Square APIs, webhook event handling, and building secure, scalable middleware services tailored for retail environments. I can develop your middleware to auto-apply member discounts via payment card fingerprints on Square for Retail, supporting individual and family memberships with multiple linked cards. I’ll ensure seamless integration with Square’s Payments, Orders, Customers, and Catalog APIs for real-time discount application, accurate membership detection, and audit logging. My solution will include a secure admin portal with role-based access for managing memberships, card enrollment, logs, and exporting data. I follow best practices for security, GDPR compliance, and low-latency webhook processing to meet your ≤ 2s performance target. I’m familiar with AWS containerized deployments and observability tools to deliver a robust production-ready system. Please share your detailed priorities; I’m ready to start and deliver quality work aligned with your project goals. Best regards, Karthik
£235 GBP in 7 days
5.7
5.7

⭐ Hi, My availability is immediate. I read your project post on Square POS System Setup. We are experienced full-stack Python developers with skill sets in - Python, Django, Flask, FastAPI, Jupyter Notebook, Selenium, Data Visualization, ETL - React, JavaScript, jQuery, TypeScript, NextJS, React Native - NodeJS, ExpressJS - Web App Development, Data Science, Web/API Scrapping - API Development, Authentication, Authorization - SQLAlchemy, PostegresDB, MySQL, SQLite, SQLServer, Datasets - Web hosting, Docker, Azure, AWS, GPC, Digital Ocean, GoDaddy, Web Hosting - Python Libraries: NumPy, pandas, scikit-learn, tensorflow, etc. Please send a message So we can quickly discuss your project and proceed further. I am looking forward to hearing from you. Thanks
£230 GBP in 3 days
5.8
5.8

Hello there, we are a team and experts in Full stack developer, PHP, Azure, cloud computing, DevOps. Please, send me a message to discuss the work and finish in no time. Thanks Ashish Kumar.
£135 GBP in 7 days
5.7
5.7

Hello, I am fully prepared to develop a robust middleware and admin portal that seamlessly auto-applies member discounts via payment card fingerprints in Square for Retail, including support for Apple/Google Pay and family memberships. Key deliverables include: Real-time detection of membership from card fingerprints via Square APIs and webhooks Automatic application of discounts either pre-payment (preferred) or immediate post-payment adjustment Admin portal for membership and fingerprint management with audit logs Support for multiple cards per membership and tier-based discount rules Comprehensive error handling, security compliance (GDPR, encryption), and performance optimization to meet the ≤ 2s latency target Complete documentation, deployment scripts, and staff training materials I will ensure the solution is scalable, secure, and maintainable, with thorough testing (unit, integration, UAT) and monitoring dashboards for real-time observability. Looking forward to delivering a seamless, automated discount experience that boosts member satisfaction and operational efficiency.
£120 GBP in 4 days
5.5
5.5

Hi, thanks for posting. Just checked job description that Project Brief — Auto-Apply Member Discounts via Payment Cards (Square for Retail) Objective When a customer pays in Square for Retail, automatically detect membership by matching the payment card fingerprint (including Apple/Google Pay) to your membership records, then apply the correct discount with no staff action I have carefully checked your requirements and could easily work with you. I would like to let you know that I have expert and commercial experience in PHP, API Development, MySQL, Software Development, Point of Sale, Software Architecture, Node.js, C# Programming, Business Consulting and API Integration. My skills are: Laravel, PHP, Codeigniter, Core PHP, HTML, CSS, and Javascript. Here are my other skills Front End: UI/UX Designer, Graphics Design, Vue.js, React, react.js, Node.js, Angular.js, HTML 5, CSS 3, Bootstrap, JavaScript, JQuery, Basic Photoshop, Figma, Webflow. Back End: PHP, Laravel, Codeigniter, Cake PHP, Ajax, jQuery, MySQL, Python. My work Capability : Responsible for communication for more than 10 hours each day. 8 Hours/Day and 40 Hours/Week. Daily or Weekly update.I am ready to work in a customized time zone i.e. EST/IST time zone and so. Waiting for your response!! Regards!
£150 GBP in 1 day
4.5
4.5

Hello, I’ve reviewed the brief regarding automating member discounts within Square for Retail – essentially, streamlining the process of applying discounts based on payment card fingerprints. My experience building integrations with Square and managing membership systems aligns perfectly with this project’s requirements. I’d be happy to discuss the technical details and provide a more detailed estimate.
£135 GBP in 5 days
4.6
4.6

Hi, I’ve carefully reviewed your project brief and have direct experience building Square API–integrated middleware, real-time webhook processors, and secure admin portals for retail workflows. This project aligns perfectly with my expertise in Node.js/Python backends, PostgreSQL data modeling, and PCI/GDPR-compliant payment handling. Here’s how I can deliver your MVP within scope: -Square API/Webhook Integration -Membership & Family Plan Logic -Pre-Payment Discount Injection -Secure Admin Portal -Edge Case Handling Tech Approach: -Backend: Node.js (TypeScript) + Express or Python (FastAPI) -DB: PostgreSQL with unique fingerprint constraints Infra: AWS Fargate/Lambda with HTTPS, WAF, and OpenTelemetry monitoring -Admin UI: React or lightweight Vue with secure JWT authentication Questions before starting: -Do you already have Square Catalog discount objects created, or should I provision them? -Is a staging Square account available for UAT before production rollout? -Do you want full-feature family membership support in MVP or phase it in later? -Will the admin portal require multi-language support? I can start immediately and aim to deliver a tested, documented MVP within your performance targets. Let's connect and discuss about this!!
£125 GBP in 4 days
4.8
4.8

Exciting project! Automatically applying member discounts via Square for Retail payment cards aligns perfectly with my experience automating complex workflows. Leveraging Square APIs, we will seamlessly link payment fingerprints to membership records and apply discounts without manual intervention. Our team's expertise in Node.js, PostgreSQL, and AWS ensures a robust solution meeting your performance targets while maintaining security and compliance. 100% refund if I fail to deliver. Simple as that. Looking forward to bringing this project to life, Alex
£150 GBP in 3 days
3.3
3.3

Hi Gordon, Thank you for providing such a detailed project description for the auto-apply member discounts via payment cards for Square for Retail. This innovative solution addresses a crucial need for automating discounts based on membership, leading to increased efficiency and customer satisfaction. I am Abdul Haseeb Siddiqui, with over 6 years of experience in PHP, C# programming, software architecture, MySQL, Node.js, and API development. My extensive background in software development and business consulting will be instrumental in delivering a seamless integration that meets your outlined scope, including the admin portal and webhook handling. I would love to offer you my services for this exciting project. You can view my previous work and portfolio here: https://www.freelancer.com/u/haseebsidd07 Looking forward to the possibility of collaborating on this project. Thanks, Abdul Haseeb Siddiqui
£20 GBP in 7 days
3.4
3.4

yes! Imagine customers tapping their phone and the right membership discount appearing like magic at checkout. I will build a secure middleware that listens to Square payment created webhooks reads card fingerprints matches them to memberships supports individual and family plans applies discounts by updating orders or issuing instant adjustments and gives you an admin portal to enroll cards manage memberships and audit every match
£135 GBP in 7 days
3.4
3.4

With over 8 years of experience in API development and programming with languages such as Python, .NET, and SQL Server, I am more than capable to handle your Square POS system setup project. Additionally, I'm skilled in automation techniques and data analysis which would be crucial for the flow and management of complex data such as multiple payment fingerprints to one membership, discount rules and applying selective discounts based on order or member types. I can guarantee my commitment to delivering high-quality code and effective software solutions. My portfolio includes significant work in improving and streamlining business processes, which aligns perfectly with the goals of your project. My proficiency in languages such as C#, VB.NET, ASP.NET will help creating a robust application that will effectively detect membership by matching payment card fingerprints using Square APIs/Webhooks & make the correct discount adjustment by updating the open order in Square for Retail. Choose me for your project’s technical excellence, timely delivery, and efficient problem-solving skills. I am excited about this opportunity to deliver a solution that answers all your project needs while enhancing user experiences for seamless transactions through comprehensive automation. Let's bring your vision to life!
£200 GBP in 5 days
3.5
3.5

Hello, Having spent over two decades honing my skills and expertise as a Software Developer and Architect, I can confidently say that this project aligns perfectly with my capabilities. My extensive experience in handling complex systems, coupled with my deep understanding of APIs and their integration, will prove instrumental in meeting your Square POS needs. I am well-versed in backend systems and have worked extensively with APIs, including payment receipt data analysis and processing - skills that are key requirements for this project. Another aspect where I believe I can deliver exceptionally is in the implementation of smart discount logic demanded by the project. My tenure has seen me consistently deliver secure, scalable solutions while keeping mindful of business logic nuances. This translates precisely into what is essential for your project – accurate detection of membership type and priority-based discount application. From memberships to payment fingerprints to discount updates, every stage in the project flows seamlessly with my expertise. Moreover, as an ardent follower of best practices, aporan databases) Lastly, ensuring smooth internal operations through automating processes like membership management and generating logs falls beautifully inline with my past experiences. As a leader in the field who has managed teams across continents successfully throughout his career, I understand the importance of seamless cr Thanks! Hakan
£150 GBP in 1 day
2.9
2.9

As a seasoned web developer with a strong grip over APIs, database management, and payment gateways, I am confident that I can deliver an exceptional solution for implementing the Square POS System in your retail store. My decade-long experience is backed by strong skills in API development and integration, C# programming, MySQL, Node.js and PHP – all of which will be instrumental in achieving the goal of this project.
£135 GBP in 7 days
2.4
2.4

Sompting, United Kingdom
Member since Aug 11, 2025
₹1500-12500 INR
$250-750 USD
₹12500-37500 INR
$250-750 USD
$250-750 USD
$10-1350 USD
₹1000-2000 INR
$250-750 AUD
£20-250 GBP
₹600-1500 INR
$250-750 USD
₹12500-37500 INR
€5000-10000 EUR
$30-250 USD
min ₹5000000 INR
₹12500-37500 INR
€30-250 EUR
₹1500-12500 INR
$3000-5000 USD
$30-250 USD