--- title: "US E-commerce Practice Notes - Military Sales" description: "An introduction to the operating rules of the US military's joint supply websites, AAFES and ShopMyExchange, and how to integrate with the military e-commerce sales platform via an FTP order process." canonical_url: "https://blog.markkulab.net/en/post/military-sales" author: "Mark Ku" author_url: "https://blog.markkulab.net/en/author/mark-ku" site: "Mark Ku's Tech Notes" date_published: "2024-01-04 01:01:35 +0800" category: "E-Commerce" tags: ["military", "ecommerce", "aafes", "shopmyexchange", "ga4", "clarity"] language: "en" license: "CC BY 4.0" license_url: "https://creativecommons.org/licenses/by/4.0/" attribution: "when reusing or quoting, credit the author and link back to the original" --- # US E-commerce Practice Notes - Military Sales ## Background Our company wanted to rebuild the website for the Army and Air Force Exchange Service (AAFES) and, in the process, understand its operational rules and the relationship between AAFES and ShopMyExchange. ## Understanding AAFES (Army and Air Force Exchange Service) The Army and Air Force Exchange Service (AAFES), part of the U.S. Department of Defense, was established in 1895. It plays a crucial role in providing services to the U.S. military and their families, operating retail stores, service facilities, and food services on military bases. The goal is to enhance the quality of life for service members and their families. As the 53rd largest retailer in the United States, AAFES supports the morale and welfare of military personnel by offering quality goods and services. AAFES also operates the e-commerce site ShopMyExchange.com, which exclusively serves authorized customers, including active-duty military personnel, veterans, reservists, National Guard members, U.S. Department of Defense civilian employees stationed abroad, State Department officials working in foreign countries, and their families. This platform offers a wide range of products, including kitchenware, lawn and garden supplies, home goods, and sports and outdoor equipment. All items are tax-free, allowing members of the military community to enjoy more affordable prices. ShopMyExchange places a high value on customer information privacy and security. Whether an order is placed through the website, by phone, or by fax, suppliers cannot know the identity of the person or military unit placing the order. ## MILITARY STAR® Card: A Credit Card Designed for Service Members The [MILITARY STAR® Card](https://www.myecp.com/) is a credit card issued by AAFES, specifically tailored for U.S. service members and their families. This card offers a variety of unique benefits and conveniences, including: * Special Offers: Cardholders can enjoy discounts and promotional offers when shopping at military exchange stores and their online platforms. (Often includes rewards of around 10%.) * Flexible Payment Options: The card offers various payment methods, such as installment plans. * Low Interest Rates: Compared to many commercial credit cards, the MILITARY STAR® Card typically has lower interest rates. * Rewards Program: Consumers can accumulate points and redeem them at military exchange stores. * Dedicated Service: Customer service and support designed for service members and their families. * ShopMyExchange.com: The ultimate convenience for online shopping. ![Reward](https://blog.markkulab.net/content/markku/posts/military-sales/images/1.png) ## Two Shopping Methods ShopMyExchange.com users have two ways to make purchases, but only the second one requires programmatic integration (this project uses the second method). * 1. Listing products directly on the ShopMyExchange.com website. * 2. Building our own AAFES website, which provides richer product information based on our backend database configuration. ## Objective To enable authorized military customers shopping on the [ShopMyExchange website](https://www.shopmyexchange.com/). When a user clicks on a "Specialty Store: XXX" link, they are redirected to our custom AAFES website. This site provides richer product information and allows users to add items to a cart. For checkout, the user is redirected back to ShopMyExchange to pay. After the user completes the payment on ShopMyExchange, ShopMyExchange uploads the order data to a designated FTP server. We then use a scheduled task to download the data from the FTP server and generate the order in our system. ![Search result](https://blog.markkulab.net/content/markku/posts/military-sales/images/2.png) ## Non-Functional Requirements * Integrate GA4 and Advanced Ecommerce reporting (up to the Checkout step, but not including Purchase). * Integrate Clarity for heatmap analysis. ## Swimlane Diagram The process is somewhat similar to the integration for a government joint supply contract. This transaction method protects the buyer's security and privacy, while also giving us more flexibility to customize our website. ![Swim-lane diagram](https://blog.markkulab.net/content/markku/posts/military-sales/images/3.png) --- ## About this article and its author Originally published on [Mark Ku's Tech Notes](https://blog.markkulab.net/en/post/military-sales) License: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — when reusing or quoting, credit the author and link back to the original ### About the author **[Mark Ku](https://blog.markkulab.net/en/author/mark-ku)** — Software Solution Provider - 10+ years senior software engineer, now an AI Builder - Focused on large-platform architecture — North-American e-commerce, AI SaaS subscription billing - Combining AI Agents and automation to build evolvable product foundations ### Free tools built by the author All of these are free to use: - [Free PDF Sign Tool](https://blog.markkulab.net/en/tools/pdf-sign): Online PDF sign tool — draw, type, or upload a signature, then drag, resize, and download. Everything runs in your browser; nothing is uploaded. - [VS Code Refactory](https://blog.markkulab.net/en/tools/refactory): Refactory is a VS Code refactoring extension: 34 actions plus a 37-rule code-smell inspection layer with a Code Health dashboard, across 18 languages, backed by 534 tests. It learns your repo's conventions: where interfaces live, where DI is registered, whether 'use client' belongs. It ranks files by git churn × complexity so you know what to fix first, and hands any smell to the Claude Code already on your machine. Free to use, and your source never leaves your computer. - [DB-Kit Database Manager](https://blog.markkulab.net/en/tools/db-kit): DB-Kit is a lightweight, cross-platform database manager built with Tauri + Rust + React. Manage MySQL, MariaDB, PostgreSQL, SQL Server, Oracle, SQLite, MongoDB, Redis, Kafka, Elasticsearch and RabbitMQ from one consistent interface: passwords encrypted in the OS keychain, SSH tunnels, full CRUD, a visual query builder, stacked multi-statement result sets, cross-connection data transfer and compare/sync, Excel / CSV import & export, visualized execution plans, ER diagrams, scheduled backups, SQL stress testing with p50–p99 latency percentiles, a 15-rule SQL review engine, Kafka message browsing with monitoring & alerts, a bilingual UI (Traditional Chinese / English), a built-in AI assistant (natural-language SQL, AI review and tuning advice) and the dbk CLI. Free and open source (MIT), with installers for Windows, macOS and Linux. - [VS Code Super Mermaid](https://blog.markkulab.net/en/tools/super-mermaid): Super Mermaid is a VS Code extension for beautiful Mermaid diagrams out of the box: auto-colored live preview, mouse pan & zoom, high-res PNG / SVG export, 21 templates and multiple themes. Free and open source (MIT). - [React Super Mermaid](https://blog.markkulab.net/en/tools/react-super-mermaid): react-super-mermaid is an open-source React component library: render beautiful Mermaid diagrams with a single , with built-in colorful / sketch themes, pan & zoom, in-diagram search, and high-res SVG / PNG export. Lightweight, SSR-safe, fully typed. Free and open source (MIT). - [Jira / Confluence Super Mermaid](https://blog.markkulab.net/en/tools/jira-super-mermaid): An Atlassian Forge app: write Mermaid syntax directly inside a Jira issue or a Confluence page and get flowcharts, sequence diagrams, state machines and Gantt charts. 11 diagram types, SVG / PNG export, light and dark themes, full CJK support. Runs on Atlassian: your diagrams live in your own site and the app calls no third-party service. Free, coming soon to the Atlassian Marketplace. - [Mermaid Live Preview](https://blog.markkulab.net/en/tools/mermaid-preview): Write Mermaid in your browser, see it render instantly, and share the whole diagram as a single link. No sign-up, nothing uploaded to a server, and mermaid.live share links work as-is. - [React Intl Phone Number](https://blog.markkulab.net/en/tools/react-intl-phone-number): react-intl-phone-number is an open-source React component: framework-agnostic and antd-free, with E.164 in/out, a searchable flag / country-code dropdown, configurable validation levels (strict / mobile-strict / loose), themeable CSS, and i18n — phone logic powered by google-libphonenumber. Lightweight and fully typed. Free and open source (MIT). - [Uptime Kuma Cluster](https://blog.markkulab.net/en/tools/uptime-kuma-cluster): Turn single-node Uptime Kuma into a highly available cluster: OpenResty + Lua smart load balancing, shared MariaDB state, health checks and automatic failover, plus cluster-management REST APIs. One Docker Compose command to start. Free and open source (MIT). - [Special Education](https://blog.markkulab.net/en/education): Learning materials crafted for special education students ### Daily podcasts - [Mark's Tech Insights — Daily AI News](https://blog.markkulab.net/en/category/tech-news): Daily curated AI and tech trends. Catch the latest developments via audio summaries — covering AI applications, software architecture, DevOps, and engineering practice. — RSS: https://blog.markkulab.net/feed.xml - [AI股市蝦聊](https://blog.markkulab.net/en/category/ai-stock-chat): Every trading day, an AI-analyzed take on the Taiwan stock market, delivered as a two-host conversation covering the session and the next-day outlook. — RSS: https://blog.markkulab.net/ai-stock-chat/feed.xml - [開源好物週報](https://blog.markkulab.net/en/category/open-source-weekly): A weekly two-host pick of free open-source tools surfaced from real Hacker News, GitHub, and Reddit buzz — what pain they solve and the fastest way to get started. — RSS: https://blog.markkulab.net/open-source-weekly/feed.xml ### Newsletter [Subscribe to the newsletter](https://blog.markkulab.net/en/subscribe) — Be the first to know about new posts. No spam, unsubscribe anytime.