Overslaan naar inhoud

Wallet Passes: Apple Wallet & Google Wallet for Loyalty

US$ 600,00 US$ 600,00
$ 1.980.000,00

Algemene voorwaarden
Geld-terug-garantie van 30 dagen
Verzending: 2-3 werkdagen

¿Listo para implementarlo en tu Odoo?

Agenda una demo o habla con un consultor y resuelve tus dudas antes de comprar. Instalación, configuración y soporte incluidos.

Wallet Passes icon

Wallet Passes: Apple Wallet & Google Wallet for Loyalty — Odoo 20

Odoo loyalty cards, eWallets, gift cards and coupons as Apple Wallet and Google Wallet passes that update automatically from Point of Sale, Sales and eCommerce

Tarjetas de puntos, monedero, tarjetas regalo y cupones de Odoo en Apple Wallet y Google Wallet, que se actualizan solos desde la caja, Ventas y eCommerce

Odoo 20 Apple Wallet Google Wallet Point of Sale / Punto de Venta Requires Odoo Enterprise / Requiere Odoo Enterprise Any country, within the limits Apple and Google set in each country Cualquier país, con las limitaciones de Apple y Google en cada país OPL-1

English

Description


Wallet Passes for Odoo 20 turns the cards of your Odoo loyalty programs into Apple Wallet and Google Wallet passes: points cards, eWallets, gift cards, coupons and memberships. When the customer buys, redeems or tops up, Odoo updates the pass on their phone. Where there is no wallet, the customer gets a permanent web card with a QR code and a PDF that your Point of Sale reads just the same.

Everything runs in your Odoo with your own Apple and Google accounts: there is no central server in between and GRUPO MI ERP receives none of your customers' data. Odoo remains the source of truth: the pass shows a snapshot of the balance, and the Point of Sale validates every redemption in Odoo.

No new hardware, no app of your own. The Point of Sale reads the pass QR or Code128 with the same scanner and Odoo's native redemption, and you do not need to publish an app.
For every customer. iPhone with Apple Wallet, Android with Google Wallet where it is available and, on any other phone or in any other country, the permanent web card.
For any country. Languages, the currency of each program, time zones with daylight saving time, multi-company, multi-brand and per-country policy packs.
Within Apple's and Google's rules. Transactional notifications; promotions only for customers who asked for them, always silent on Apple; and nothing is sent to Apple or Google until an administrator of Odoo and of Wallet accepts the data sharing, with the acceptance recorded.

Key features


Four card types
  • Points card: the points are shown in the pass header.
  • eWallet and gift card: the balance, in the program's currency.
  • Single-use coupons, next-order coupons included: once redeemed, the pass is voided.
  • A pass is created when someone asks for it or, if the program offers it automatically, with the card's first movement; never when the card is created: carts without history create no passes.
  • Card design with a live preview: see the Apple Wallet pass, the Google Wallet pass and the iOS 27 poster side by side while you change colors and images, with contrast and image-size warnings, and start from 24 ready-made designs by sector (coffee shop, bakery, restaurant, pizzeria, bar, ice cream, retail, beauty, barbershop, fitness, pharmacy, supermarket, pet shop, florist, jewelry, electronics and more) or save your own.
Automatic updates
  • Every sale, redemption, top-up or expiry queues the pass outside the Point of Sale transaction: selling never waits for Apple or Google.
  • Apple: Odoo sends an APNs push and the iPhone downloads the new pass from your Odoo.
  • Google: Odoo updates the pass through the API, and the phone shows it when it syncs.
  • If the pass did not change, nothing is sent. Retries with backoff, and a circuit breaker that pauses the brand if many balances drop to zero with no sale to explain it.
Transactional notifications
  • Apple: a system notification when the points change, when a reward is available and about expiry; for eWallets and gift cards, a text with no amount ("Your balance was updated").
  • Google: on points cards, a notification when a purchase or a redemption changes the points or a reward becomes available (at most 3 per pass every 24 hours), a reminder of points expiring in 7 days, and Google's own notice when a coupon is about to expire.
  • Reminders respect the time windows and public holidays of the country's policy pack (the module ships the holidays of Colombia; you add those of other countries); what a purchase triggers goes out right away.
  • Odoo records notifications as sent, never as "delivered".
At the Point of Sale
  • QR code on the receipt, on the end-of-sale screen and on the customer display; the till that created the order prints it offline too.
  • The printed QR works once, for a paid order of the last 72 hours, and only leads to loyalty cards, coupons and cards without a holder: an eWallet or a gift card with a holder never goes out on a receipt.
  • "Send pass" after payment by email, SMS or WhatsApp, and by email from the customer list; "Find or type a pass" by code or phone number.
  • The scanner applies the card with Odoo's native redemption, on the product screen and on the payment screen.
  • Both registers are warned if the same card is used at two registers less than 10 minutes apart. With employees at the register, you choose which levels may show, send and look up passes.
Sales, eCommerce, email, SMS and WhatsApp
  • Optional welcome by email, SMS or WhatsApp with the card's first movement, once per card, and buttons in the /my portal.
  • Apple, Google and web card buttons next to each gift card bought, on the order's portal page and on the eCommerce confirmation; a gift card without a holder can be sent to someone else with the link to its pass.
  • SMS with a link on your own domain, and WhatsApp (Enterprise) with one template per language that Meta must approve.
  • SMS and WhatsApp only go to customers who gave that channel's consent; email respects the customer's refusal; Odoo's blocklists are always respected.
Universal page and web card
  • One link: Apple Wallet on iPhone, Google Wallet on Android where it is available, and the web card everywhere else.
  • On iPad or Mac, a QR code to open the pass on the iPhone; in the WhatsApp, Instagram or Gmail in-app browsers, a notice to open it in Safari or Chrome.
  • Permanent web card with QR code, Code128, balance and PDF: the customer can add it to the home screen and it does not expire.
  • Asks for any missing consent according to the country, with no cookies and no third-party resources.
Nearby stores
  • Up to 10 stores per pass: where the card was issued and where the customer bought recently (both with the Point of Sale), those near the customer's address and your featured stores; you can also choose them by hand.
  • iPhone: a silent suggestion on the Lock Screen, with your own text per store; iOS decides whether to show it.
  • Android: Google sets the text, the radius and the frequency.
  • The phone's location never reaches Odoo.
Guided onboarding and health dashboard
  • A wizard that takes each brand from zero to production and can be resumed: the Apple team, the Google issuer, the pass types and a checklist with the legal texts and the badges.
  • The Apple key and certificate signing request (CSR) are generated in Odoo: no Mac needed.
  • A dashboard with more than 40 checks (certificates, membership, queue, Google review, public reachability) and how to fix each one; a brand only goes to production with no red check.
  • Certificate expiry alerts at 60, 30, 7 and 1 days, renewal without revoking the old certificate, an incident procedure for a compromised certificate, and an exportable diagnosis with no personal data.
Security and fraud prevention
  • Keys are stored encrypted, and the .p12 file and the Google JSON key are deleted as soon as they are imported. A backup holds the encrypted keys and what opens them: protect your backups as credentials.
  • A copy of the database (duplicated, restored as a copy or neutralized) sends nothing: the brand pauses itself.
  • For eWallets and gift cards, Apple hides the Share button by default and Google asks to unlock the phone to see them; on Google, every pass has a single holder.
  • Point of Sale users cannot read Wallet models, and links expire: 3 uses in 24 hours from the register, 3 uses in 72 hours by WhatsApp.
  • "Download .pkpass" only exists for test passes, and the Google JSON export masks the card code. The employee levels of the register are an interface control, like every pos_hr permission.
Lifecycle and privacy
  • Used coupon, archived or expired card: the pass is voided or expires; if the card is reactivated, the same pass comes back.
  • Contact merges and deletions leave no orphan passes.
  • Erasure from Odoo's Privacy Lookup: the pass is voided and the personal data the merchant controls is removed.
  • Insert-only consents per channel and purpose, retention periods set in the policy pack of the brand and a merchant offboarding wizard.
Campaigns
  • Promotions by Wallet (silently in the pass, or with a notice on Google), email, SMS and WhatsApp, with texts per language, image, link and dates.
  • Audience by the pass snapshot (balance, tier, expiry, state, installed), never by the history: customers who object to profiling stay out of segments, and minors are never reached.
  • A content validator (Google lengths, links only to your domains, restricted sectors, the EU 30-day price rule, required languages) and approval by a second Wallet administrator.
  • Only to customers with the promotional consent of each channel, in their local time window and outside holidays, within the caps of their policy pack across channels (Colombia: one promotion a day and one channel a week); every message carries a one-click unsubscribe link.
  • Figures: passes reached per channel, saved and deleted, unsubscriptions and purchases in the campaign window; never "delivered".
Promotions in the pass
  • Only for customers who accepted the promotions in Wallet; everyone else keeps their own coupons, rewards and expiries.
  • Apple: a "Promotions for you" field on the back, a temporary strip and a note near the stores, always silent, and only promotions redeemed with the pass or exclusive to the program's members.
  • Google: the campaign as a message (with a notice inside the quota) and its image, and the promotions of your programs as value-added modules.
  • The automatic promotions of Odoo that you choose are shown while they are in force, and everything leaves the pass with one update when it ends.
Coupons, bundles and campaign passes
  • Google (optional): the customer's coupons reach the phone by themselves, linked to the saved loyalty card, in slots that are reused, never more than 50 per card.
  • Apple: one .pkpasses bundle of up to 10 coupons and campaign passes in the links by email, SMS, WhatsApp and the portal, never with a balance; a limit of live coupons per customer (10 by default).
  • Campaign passes for promo codes, automatic promotions and buy X get Y: one pass per customer with the rule's code, voided when the program ends.
Odoo marketing apps and Gmail
  • Loyalty communications ("at creation" and "when reaching") as a silent message in the pass, by SMS or by WhatsApp.
  • Email Marketing: Wallet passes as mailing recipients, with filters on the snapshot and the campaign rules.
  • Marketing Automation (Enterprise): a Wallet step that updates the passes or sends an approved Wallet campaign.
  • Gmail (optional): the email of a loyalty card can offer to add it to Google Wallet, once Google turns it on for your sender.
Analytics and public sign-up
  • Passes issued and installed (each pass once, iPhone and Apple Watch together), deletions, sign-ups, notices and errors, and purchases in each campaign window, by day, brand, program, wallet, country and campaign; no names or emails.
  • Public sign-up from a QR poster or an NFC tag at the till: one form with the consents of the policy pack, double opt-in by email and its own anti-spam (signed form, trap field, 5 attempts per IP per hour), with no third parties.
  • An optional captcha of Google reCAPTCHA or Cloudflare Turnstile, per brand.
Tiers and memberships
  • Tiers per program by balance, by the points earned in a period or, with Partnership, by the partner level of the customer's company: name, colors and image per tier, a Google Wallet class per tier, and one notification only when the customer moves up.
  • Membership passes without a card, whose code is the customer code that the Point of Sale reads; with Subscriptions (Enterprise), active, paused or voided as the subscription goes.
  • Membership hours, which the iPhone uses to suggest the pass; the member's photo only on Apple Wallet and off by default.
iOS 27 and App Store Connect
  • Poster passes with your artwork on iOS 27, with the classic pass behind them for iOS 26 and earlier, synced by iCloud.
  • Up to two Featured Actions under the pass: the customer portal, the online shop and, for eWallets, Add to Balance towards the web top-up.
  • Linear barcodes on iOS 27 (EAN-13, Code 39, Codabar, ITF) with the QR behind them; the Point of Sale reads both.
  • Pass Type IDs and certificates created and renewed through the App Store Connect API with a Team key that is deleted when done; the APNs key of the team as an experimental option.
Kiosk, self-order and restaurant
  • The confirmation page of the kiosk and of the self-order shows the QR of the pass, or of the public sign-up when the customer has no card; never an eWallet or a gift card with a holder.
  • Split bills ask who earns the points of the new part: the customer, a scanned pass, another customer or nobody.
Android without Google Wallet, rotating codes and migrations
  • WalletPasses (optional, off by default) for Android phones without Google Wallet, with its own pushes and never APNs.
  • Optional rotating QR on Google Wallet that changes every 30 seconds and is checked only by Odoo: a screenshot stops working.
  • Migrations to a new domain, to a new Apple Pass Type ID, or of the cards of another provider, with the dashboard following the old devices.
Web top-up, Apple Pay and Google Pay
  • eWallet top-up without logging in, from the web card and from Add to Balance on iOS 27: the customer pays the quotation in your portal and the balance updates by itself.
  • Apple Pay and Google Pay through the payment providers of Odoo that offer them, such as Stripe, Adyen and Mollie; Apple Pay needs the domain verified for each database.
  • The web card of a gift card leads to its product in your shop.
  • A "Membership number" field at checkout and in the portal that Chrome can fill in from Google Wallet; it never moves points or balance.
NFC and sign-up from the wallets (off until you set them up)
  • Apple NFC: the pass for Apple VAS terminals and the sign-up from Apple Wallet, which never skips the consents of the policy pack; it needs the NFC certificate that Apple grants.
  • Sign-up from Google Wallet: the customer joins the program from Google Wallet, with gift card sign-in and save restrictions with Sign in with Google, once Google turns them on.
  • Smart Tap: an Android phone presents its Google Wallet pass over NFC to a reader that Google certified, which types the code of the card at the Point of Sale; your own Redemption Issuer and keys, and Odoo never keeps the private key of a reader. Bounceback, a pilot of Google, on request.
  • Included in the module and off until you set them up: Apple or Google approve each merchant first.
Orders, events, Merchant Center and age (off until you set them up)
  • Apple Wallet orders for the eCommerce: the customer follows his order and its delivery in Wallet (needs an Order Type ID and a Merchant ID of Apple Pay).
  • Event tickets in Apple Wallet and Google Wallet from the registrations of Events, with the times of the event; off on each event until you turn it on.
  • Member benefits in Google Search and Shopping: the loyalty attributes of the Merchant Center feed (program, member price and tier).
  • Age verification with Verify with Wallet (iOS 26, Safari): the page of the pass and the public sign-up ask only whether the customer is the age that his policy asks for, with an ID in Apple Wallet, and keep only the result; for brands and customers of the United States and Japan.
Limits set by Apple and Google
  • Updates. Apple: within seconds or minutes, if the customer keeps the pass's automatic updates and notifications on; APNs stores a single notification for 30 days at most. Google: when the phone syncs, up to 24 hours; Google gift cards update without a documented notification.
  • Notifications. None has guaranteed delivery or a fixed time, and the customer can turn them off. Odoo never reports notifications as "delivered", only as sent.
  • Proximity. It is a passive, silent suggestion on the Lock Screen: the system decides and it cannot be measured. Apple: your own text per store, without a notification; the customer needs "Suggest on Lock Screen" and location access for Wallet, and the radius is about 100 m. Google: Google sets the text, the radius and the frequency, merchant text is not supported, and the customer needs notifications on and precise location set to "always".
  • Promotions. Apple: always silent, never a notification, and only promotions tied to the pass; if a version of iOS does not show the temporary strip, the promotion stays on the back. Google: at most 2 of the 3 notices of a pass every 24 hours go to campaigns (the third stays for reminders), titles under 29 characters and texts under 40 folded or 80 unfolded, and app links stay off until Google confirms they need no allowlist.
  • Coupons. Google links at most 50 passes to a card in its whole life, and gets each linked coupon without the customer tapping its button. Apple never groups coupons: a bundle holds 10 passes at most, and Gmail's added cards never update themselves.
  • iOS 27. The poster, the Featured Actions and the linear barcodes need iOS 27; earlier versions show the classic pass with its QR. Rotating codes exist only in Google Wallet on Android: Apple Wallet, the web card and the PDF keep the card code.
  • Payments. Apple Pay and Google Pay come from your payment provider, in the countries where they exist (Colombia yes, Venezuela no). Whether Chrome fills in the membership number from Google Wallet has not been confirmed on a phone yet.

Screenshots


A tour of the product from start to finish, taken on a demo database with test data; no real customer appears.

Wallet Dashboard
Wallet Dashboard

Start here: live passes, installations in Apple Wallet and Google Wallet, points issued and redeemed, purchases by weekday and hour, campaign results and members by tier, for the last 7, 30 or 90 days or 12 months. Charts by Apache ECharts; only figures of groups, never a customer.

Live preview of the card design
Design your card with a live preview

In the brand, the Apple Wallet pass, the Google Wallet pass and the iOS 27 poster are drawn as you change colors and images, before saving, with warnings when the contrast is low or an image will be cut.

Gallery of ready-made designs
24 ready-made designs

Twenty-four designs by sector, each shown with your own logo and name: one click sets the colors, the strip, the hero image and the poster, and you can save your own design for your company.

Program tiers and their preview
Programs and tiers

Turn Wallet on in a loyalty program and give it tiers: each tier has its own colors and images, with the same preview and the same designs.

Passes
Passes

Every pass with its program, customer, balance, Apple devices, Google Wallet save and status.

A pass
A pass

The published data of a pass (balance, tier, expiry), its Apple devices and its Google object, and the buttons to send its link, revoke its web card or void it.

Web card
Web card on the phone

The page of the customer, with the colors and the logo of the brand: balance, QR and barcode for the checkout, PDF and recent activity. With the Apple and Google accounts of the brand, the same page offers Apple Wallet and Google Wallet.

Event ticket
Event ticket

The ticket of a registration as a pass, with the date, the venue and the code that the entrance scans.

Campaign
Campaigns

A promotion for the members of your programs: its title, text and image, the channels, the audience and the approval of a second administrator.

Campaign results
Campaign results

How many passes each channel reached, and the purchases, saved and deleted passes in the window of the campaign.

Point of Sale
Point of Sale

The cashier picks the customer and sees the points and the eWallet balance of the card; the pass updates itself after the sale.

Health checks
Health checks

What is missing or about to expire in each brand, in red and yellow, before a customer notices: accounts, certificates, policy and content. The demo brand has no Apple nor Google account, so its checks say so.

Analytics
Analytics

Passes installed by wallet and month, and the other measures of the passes, as a chart, a pivot or a spreadsheet.

Stores
Stores

The stores of the brand with their coordinates: each pass carries the ones nearest to its customer, so the phone suggests it nearby.

Policy packs
Policy by country

Policy packs by country with their versions and review dates: consent, notices, sending windows and legal texts.

How it works


From the Point of Sale receipt to the customer's wallet, in your Odoo and with your accounts:

  1. You enable Wallet on a points, eWallet, gift card or coupon program and assign it a brand: name, colors, images, stores, languages and the country's policy pack.
  2. The customer buys at the Point of Sale and Odoo adds the points or moves the balance with the native loyalty flow.
  3. After payment, the receipt, the end-of-sale screen and the customer display show a QR code; the cashier can also send the link by email, SMS or WhatsApp.
  4. The customer scans the QR code and lands on the brand's page, which asks for any missing consent for their country and offers Apple Wallet, Google Wallet or the web card, depending on their phone and their country.
  5. On iPhone, the pass is downloaded from your Odoo, signed with the certificate of your Apple account. On Android, your Odoo creates the pass at Google at that moment and the customer saves it.
  6. On every purchase or redemption, Odoo queues the pass. The publisher rebuilds the pass snapshot and, if it changed, tells Apple so the iPhone downloads the new version, and updates the pass at Google.
  7. To redeem, the cashier scans the pass code; Odoo validates the balance and applies the reward as usual.
No central server. Each merchant uses its own Apple Developer account, its own Google Wallet issuer and its own Odoo over HTTPS. GRUPO MI ERP is not in the middle and receives no data.

What your customers see on iPhone and Android


iPhone · Apple Wallet
  • A card with the brand's logo, colors and name; the points or balance at the top, and the QR or Code128 code the Point of Sale reads.
  • Points expiring soon, with their local date and time; the next reward and what is missing; the validity and the last 5 movements.
  • On the back: terms, the merchant's contact details, links to the shop, its stores, /my and the web card, and how to refresh the pass.
  • A system notification when the points change ("You have 1,250 points"); for eWallets and gift cards, without the amount.
  • Near one of your stores, a silent suggestion on the Lock Screen, if iOS decides to show it.
  • The pass also shows on Apple Watch, without change notifications. iPad does not store loyalty passes: the page shows a QR code to open it on the iPhone.
  • On iOS 27: your artwork as a poster, up to two buttons under the pass (portal, shop or Add to Balance) and, if you choose it, a linear barcode.
Android · Google Wallet
  • A loyalty card, gift card or offer, with the brand's logo, color and images and the QR code.
  • The points or balance and the validity on the card; in the details, the last movements, expiring points, terms and contact, with links to /my, the shop, its stores, the privacy policy and the web card.
  • Changes appear when the phone syncs, up to 24 hours later; at most 3 notifications per pass every 24 hours, and gift cards update without a notification.
  • Near a store, Google may show a notice with its own text.
  • eWallets and gift cards require unlocking the phone, and no one else can save the customer's card.
  • If you turn it on, a QR that changes every 30 seconds.
  • Requires Android 9 or later with Google Play services.
No wallet. Huawei with HarmonyOS, Android in a country without Google Wallet or any other phone: a permanent web card with QR code, Code128 and balance that can be pinned to the home screen, plus a PDF. The Point of Sale reads it just the same.

For any country


Languages
  • Pass, page, web card, PDF, email, SMS, WhatsApp and receipt texts included in Spanish, English, Brazilian Portuguese and French.
  • Any other active language is translated from Odoo, in Settings › Translations, without touching the code.
  • Each pass in its customer's language, Arabic and other right-to-left languages included.
  • If a translation the country requires is missing (with sale_loyalty_delivery, also the description of the free shipping reward), the pass is not issued and the dashboard says so. Odoo interface in English and Spanish.
Currencies, dates and times
  • Amounts in each program's currency and format: the yen with no decimals, the Kuwaiti dinar with three.
  • Dates and times in the customer's time zone, with daylight saving time.
  • Expiry is shown with the local date and time: in Bogotá, points expiring on 12 November disappear that day at 19:00, and the pass says so.
  • Multi-company and multi-brand: each brand signs with the Apple team of its company or of a parent company, and there is one Google issuer per company and country.
Countries
  • Apple Wallet: the merchant's Apple Developer account must be in a country where Apple accepts enrollment; Apple does not enroll merchants from countries under US embargo.
  • Google Wallet: only in the countries of Google's official list. It is not available in China, Russia, Turkey or South Korea, among others.
  • The country table ships with the module and the merchant can correct it.
  • Where there is no wallet, the web card is the universal fallback.
Per-country policy
  • 12 packs: generic, Colombia, Venezuela, Mexico, Peru, Chile, Argentina, Brazil, European Union (with a rule for France), United States (with rules for California and Washington), Canada (with rules for Quebec and Ontario) and India.
  • Consent per channel and purpose, time windows, public holidays, caps, ages, mandatory languages, retention periods and legal texts.
  • If a requirement of the pack is missing, nothing is issued or notified.
  • They are templates without legal review: the merchant marks them as reviewed with its own legal advisor.
  • A correction comes as a new version in draft that you put in force: an update never changes a pack you edited and proposes the new version on each brand.

Requirements


Odoo and server
  • Odoo 20.0 Enterprise on Odoo.sh or on-premise. It does not work on Odoo Community nor on Odoo Online.
  • A public domain with HTTPS and one database per domain, or a proxy that, on /mierp_wallet/ and /w/, sets the database (X-Odoo-Database) and the customer's real IP (X-Forwarded-For), with an exact dbfilter, proxy_mode and web.base.url.freeze.
  • Cron running (--max-cron-threads of 1 or more).
  • Python library httpx[http2] and, to complete local phone numbers in SMS and WhatsApp, phonenumbers.
  • A firewall or CDN that lets Googlebot and Google-Valuables reach the callbacks and the images.
  • Odoo apps: it is one module, and installing it installs every app it works with, if they are not there yet: Loyalty, Point of Sale (with POS Self Order and Restaurant), Sales, eCommerce, Inventory and Delivery, Events, SMS (sending needs IAP credits), Email Marketing, Partnership and, from Odoo Enterprise, WhatsApp, Marketing Automation and Subscriptions. You only set up the ones you use.
  • For the web top-up: a payment provider of Odoo; Apple Pay and Google Pay need one that offers them, and Apple Pay the domain verified for each database.
Apple and Google accounts
  • Apple Developer Program for organizations, in the name of the merchant that owns the brand (or of a licensee with written authorization): USD 99 per year, paid to Apple, and a D-U-N-S number. Nonprofits, educational institutions and government entities can request a fee waiver.
  • One Pass Type ID per pass family plus one for testing (four per brand, a fifth for campaign passes and a sixth for memberships), with certificates renewed every year.
  • One Google Wallet issuer per country, with its business and payments profile, and a Google Cloud project with the Google Wallet API and a service account with its key.
  • Google reviews the issuer and the pass classes before they are published.
Python dependencies: on Odoo.sh, add httpx[http2] to the requirements.txt at the root of your repository; on-premise, pip install -r mierp_wallet/requirements.txt.

Data and privacy


Nothing is sent to Apple or Google until an administrator of the brand (a Settings administrator who is also a Wallet administrator) accepts the data transfer in Odoo; the acceptance is recorded with their user and the date.

  • To Apple: your Odoo only sends APNs the device token, the pass type identifier (for the orders in Apple Wallet, the Order Type ID) and an empty message. The iPhone downloads the pass directly from your Odoo and sends it the device identifier, the push token and technical logs. If the customer uses iCloud, Apple syncs the pass across their devices.
  • To Google: the program class (name and logos, colors, images, featured stores, texts and links) and, only when the customer taps "Add", their pass: id, card code, balance or points, validity, the points about to expire, the rewards and the last movements, messages, stores, the terms and the contact of the issuer and, if the program enables it, the first name. Google may use this information to provide and improve its services, and it notifies your Odoo when the customer saves or deletes the pass.
  • To Odoo's IAP, for SMS (optional): the phone number and the text with the link (of the pass, of a campaign or the one that stops the promotions) go through Odoo S.A.'s IAP service and its providers.
  • To Meta, for WhatsApp (optional, Enterprise): the phone number, the template, its texts and the link go through the merchant's own Meta API account.
  • By email: the link to the page of the pass, the campaigns and the sign-up confirmation go through the outgoing mail server of your Odoo. With the Gmail option, the email of a loyalty card carries the name of the brand and of the program and the card code in a format that Gmail reads to offer it in Google Wallet.
  • To a captcha provider (optional, per brand): with Google reCAPTCHA or Cloudflare Turnstile on the public sign-up, the visitor's browser loads its script and sends it its IP; name it in your privacy notice.
  • To WalletPasses (optional, off by default): the push tokens of the Android phones that use its app and the pass type identifier; it only turns on when your privacy notices name it.
  • To your payment provider (top-up and shop): the payment and the data that your provider asks for, as in any payment of Odoo.
  • Age verification (optional, Verify with Wallet): the customer's iPhone tells your Odoo only whether he is the age asked for; Odoo keeps the result, the type of ID and its issuer, never the ID nor the date of birth, and sends nothing to Apple.
  • To GRUPO MI ERP: nothing. There is no telemetry.

Identity documents and the phone's location are never sent, and the pass page uses no cookies and no third-party resources. Each merchant is the data controller; consents are recorded per channel and purpose, with the text version, the language and the time.

Erasure: the pass is voided and the personal data the merchant controls is removed. Google keeps the pass inactive and without a name, the pass stays on the phone until the customer deletes it, and iCloud copies are kept by Apple. The minimal record left in Odoo is deleted after 30 days.

What it does not do


It does not guarantee that notifications arrive, or when; the customer can turn them off.
Proximity is a passive, silent suggestion that the system decides and that cannot be measured.
It cannot make Google show a change before the phone syncs: it can take up to 24 hours.
It does not delete the pass from the phone: the customer does.
It does not print an eWallet or a gift card with a holder on a receipt, and an order paid at a register other than the one that created it has no offline QR.
The country packs are templates without legal review; they are not legal advice.
It never advertises through an Apple notification: Apple promotions are silent, on the back of the pass. On Google, a campaign notifies at most twice per pass every 24 hours, and only customers who accepted the promotions in Wallet.
The web card and the PDF do not show the promotions of the pass, and a promotion that reaches its usage limit through sales stays on the passes until their next update.
Analytics only count what Odoo keeps: once events are purged, older deletions, notices and errors go with them.
It does not work on Odoo Online or on Odoo 19 and earlier.
It does not take payments itself, and it cannot top up a gift card online: Odoo sells a new one. The membership number never moves points, balance or ownership.
It does not include what requires a native app (Tap to Pay, Tap to Share), boarding passes, or Huawei Wallet and Samsung Wallet passes: those customers use the web card.

Technical details


  • One module, mierp_wallet: Point of Sale, Sales, eCommerce, SMS, WhatsApp, Email Marketing, Marketing Automation, Partnership, Subscriptions, POS Self Order and Restaurant are all inside it; there are no bridge modules to install.
  • Also inside it, and off until the brand sets each one up: Apple NFC and the sign-up from Apple Wallet, the sign-up from Google Wallet, Smart Tap, Apple Wallet orders, event tickets, the member prices of Merchant Center and Verify with Wallet.
  • Dependencies: loyalty, certificate, privacy_lookup, pos_loyalty, pos_self_order, pos_restaurant, sale_loyalty, website_sale_loyalty, stock_delivery, event, sms, mass_mailing, partnership and, from Odoo Enterprise, whatsapp, marketing_automation and sale_subscription; Python httpx and h2, and, optionally, phonenumbers for SMS and WhatsApp.
  • Main models: mierp.wallet.brand, mierp.wallet.pass, mierp.wallet.apple.team, mierp.wallet.apple.pass.type, mierp.wallet.google.issuer, mierp.wallet.google.class, mierp.wallet.location, mierp.wallet.policy.pack, mierp.wallet.consent, mierp.wallet.job, mierp.wallet.campaign, mierp.wallet.tier, mierp.wallet.migration and the mierp.wallet.analytics report; extends loyalty.program, loyalty.card, loyalty.history and res.partner.
  • Apple: .pkpass signed in Odoo (PKCS#7 with the WWDR G4 chain), Wallet web service and APNs over HTTP/2, with one connection per certificate.
  • Google: Google Wallet REST API, RS256 JWTs signed with the keys in certificate, signed callbacks (ECv2) and a shared limit of 20 requests per second per project.
  • Outbound queue with a single publisher cron, retries with backoff and a circuit breaker; each pass keeps the hash of its snapshot: if nothing changed, there is no push and no update.
  • Security with Odoo 20's ir.access.csv: Wallet User and Administrator groups; credentials only for the system administrator; cashiers cannot read Wallet models.
  • OPL-1 license: readable code, not obfuscated, no activation keys and no telemetry. Interface in English, Spanish, Brazilian Portuguese and French.

Español

Descripción


Wallet Passes para Odoo 20 convierte las tarjetas de los programas de fidelización de Odoo en pases de Apple Wallet y Google Wallet: tarjetas de puntos, monederos, tarjetas regalo y cupones. Cuando el cliente compra, canjea o recarga, Odoo actualiza el pase en su teléfono. Donde no hay wallet, el cliente recibe una tarjeta web permanente con QR y PDF que la caja lee igual.

Todo corre en tu Odoo y con tus propias cuentas de Apple y de Google: no hay un servidor central de por medio y GRUPO MI ERP no recibe datos de tus clientes. Odoo sigue siendo la fuente de verdad: el pase muestra una foto del saldo y la caja valida cada canje en Odoo.

Sin hardware nuevo ni app propia. La caja lee el QR o el Code128 del pase con el mismo escáner y el canje nativo de Odoo, y el comercio no necesita publicar una app.
Para cualquier cliente. iPhone con Apple Wallet, Android con Google Wallet donde existe y, en cualquier otro teléfono o país, la tarjeta web permanente.
Para cualquier país. Idiomas, la moneda de cada programa, zonas horarias con horario de verano, multicompañía, multimarca y paquetes de política por país.
Con las reglas de Apple y Google. Avisos transaccionales; promociones solo para quien las pidió, siempre en silencio en Apple; y nada sale hacia Apple ni Google hasta que un administrador de Odoo y de Wallet acepta el envío de datos, con la aceptación registrada.

Funcionalidades principales


Cuatro tipos de tarjeta
  • Tarjeta de puntos: los puntos van en la cabecera del pase.
  • Monedero y tarjeta regalo: el saldo, en la moneda del programa.
  • Cupones de un uso, también los de la próxima compra: al canjearlo, el pase queda anulado.
  • El pase nace cuando alguien lo pide o, si el programa lo ofrece solo, con el primer movimiento de la tarjeta; nunca al crearla: los carritos sin historial no generan pases.
  • Diseño de la tarjeta con vista previa en vivo: ves el pase de Apple Wallet, el de Google Wallet y el póster de iOS 27 lado a lado mientras cambias colores e imágenes, con avisos de contraste y de medidas de las imágenes, y partes de 24 diseños listos por sector (cafetería, panadería, restaurante, pizzería, bar, heladería, tiendas, belleza, barbería, gimnasio, farmacia, supermercado, mascotas, floristería, joyería, electrónica y más) o guardas el tuyo.
Se actualizan solos
  • Cada venta, canje, recarga o vencimiento pone el pase en una cola, fuera de la transacción de la caja: vender nunca espera a Apple ni a Google.
  • Apple: Odoo avisa por APNs y el iPhone descarga el pase nuevo desde tu Odoo.
  • Google: Odoo actualiza el pase por la API, y el teléfono lo muestra cuando sincroniza.
  • Si el pase no cambió, no se envía nada. Reintentos con espera y un disyuntor que pausa la marca si muchos saldos caen a cero sin una venta que lo explique.
Avisos transaccionales
  • Apple: aviso del sistema cuando cambian los puntos, cuando hay una recompensa disponible y con el vencimiento; en monedero y tarjeta regalo, un texto sin importe («Tu saldo se actualizó»).
  • Google: en las tarjetas de puntos, aviso cuando una compra o un canje cambia los puntos o hay una recompensa disponible (como mucho 3 por pase cada 24 h), recordatorio de los puntos que vencen en 7 días y el aviso propio de Google cuando un cupón está por vencer.
  • Los recordatorios respetan las franjas horarias y los festivos del paquete de política del país (el módulo trae los festivos de Colombia; los de otros países los añades tú); lo que dispara una compra sale en el momento.
  • Odoo registra los avisos enviados, nunca «entregados».
En la caja
  • QR en el ticket, en la pantalla de fin de venta y en la pantalla del cliente; la caja que creó el pedido lo imprime también sin conexión.
  • El QR impreso sirve una vez, para un pedido pagado en las últimas 72 horas, y solo lleva a tarjetas de puntos, cupones y tarjetas sin titular: un monedero o una tarjeta regalo con titular nunca salen en un ticket.
  • «Enviar pase» tras el pago por correo, SMS o WhatsApp, y por correo desde la lista de clientes; «Buscar o teclear un pase» por código o teléfono.
  • El escáner aplica la tarjeta con el canje nativo de Odoo, en la pantalla de productos y en la de pago.
  • Aviso a las dos cajas si la misma tarjeta se usa en dos cajas con menos de 10 minutos de diferencia. Con empleados en la caja, eliges qué niveles pueden mostrar, enviar y buscar pases.
Ventas, eCommerce, correo, SMS y WhatsApp
  • Bienvenida opcional por correo, SMS o WhatsApp con el primer movimiento de la tarjeta, una sola vez por tarjeta, y botones en el portal /my.
  • Botones de Apple, Google y tarjeta web junto a cada tarjeta regalo comprada, en la página del pedido en el portal y en la confirmación del eCommerce; una tarjeta regalo sin titular se puede enviar a otra persona con el enlace de su pase.
  • SMS con un enlace de tu propio dominio, y WhatsApp (Enterprise) con una plantilla por idioma que Meta debe aprobar.
  • SMS y WhatsApp solo salen para quien dio el consentimiento de ese canal; el correo respeta la negativa del cliente; las listas de bloqueo de Odoo se respetan siempre.
Página universal y tarjeta web
  • Un solo enlace: Apple Wallet en iPhone, Google Wallet en Android donde existe y la tarjeta web en el resto.
  • En iPad o Mac, un QR para abrir el pase en el iPhone; en los navegadores de WhatsApp, Instagram o Gmail, un aviso para abrirlo en Safari o Chrome.
  • Tarjeta web permanente con QR, Code128, saldo y PDF: el cliente puede agregarla a la pantalla de inicio y no caduca.
  • Pide los consentimientos que falten según el país, sin cookies ni recursos de terceros.
Tiendas cercanas
  • Hasta 10 tiendas por pase: la de emisión y las de sus compras recientes (ambas con el Punto de Venta), las cercanas a su domicilio y las destacadas; también puedes elegirlas a mano.
  • iPhone: sugerencia silenciosa en la pantalla bloqueada, con un texto propio por tienda; iOS decide si la muestra.
  • Android: el texto, el radio y la frecuencia los pone Google.
  • La ubicación del teléfono nunca llega a Odoo.
Alta guiada y tablero de salud
  • Asistente que lleva cada marca de cero a producción y se puede retomar: el equipo de Apple, el emisor de Google, los tipos de pase y una lista de comprobación con los textos legales y los badges.
  • La llave y la solicitud de certificado (CSR) de Apple se generan en Odoo: no hace falta un Mac.
  • Tablero con más de 40 comprobaciones (certificados, membresía, cola, revisión de Google, acceso público) y cómo arreglar cada una; la marca solo pasa a producción sin ninguna comprobación en rojo.
  • Alertas de vencimiento del certificado a 60, 30, 7 y 1 días, renovación sin revocar el anterior, procedimiento de incidentes para un certificado comprometido y diagnóstico exportable sin datos personales.
Seguridad y antifraude
  • Las llaves se guardan cifradas, y el .p12 y el JSON de Google se borran en cuanto se importan. Una copia de seguridad guarda las llaves cifradas y lo que las abre: protege tus copias como credenciales.
  • Una copia de la base (duplicada, restaurada como copia o neutralizada) no envía nada: la marca se pausa sola.
  • En monedero y tarjeta regalo, Apple oculta por defecto el botón Compartir y Google pide desbloquear el teléfono para verlos; en Google, cada pase tiene un solo titular.
  • Los usuarios del Punto de Venta no leen modelos de Wallet, y los enlaces caducan: 3 usos en 24 horas desde la caja y 3 usos en 72 horas por WhatsApp.
  • «Descargar .pkpass» solo existe para los pases de prueba, y la exportación del JSON de Google enmascara el código de la tarjeta. Los niveles de empleado de la caja son un control de interfaz, como todo permiso de pos_hr.
Ciclo de vida y privacidad
  • Cupón usado, tarjeta archivada o vencida: el pase se anula o vence; si la tarjeta se reactiva, vuelve el mismo pase.
  • Fusión y borrado de contactos sin pases huérfanos.
  • Supresión desde la búsqueda de privacidad de Odoo: el pase se anula y se retiran los datos personales que controla el comercio.
  • Consentimientos por canal y finalidad que no se editan, plazos de conservación fijados en el paquete de política de la marca y asistente de baja del comercio.
Campañas
  • Promociones por Wallet (en silencio en el pase, o con un aviso en Google), correo, SMS y WhatsApp, con textos por idioma, imagen, enlace y fechas.
  • Audiencia por la foto del pase (saldo, nivel, vencimiento, estado, instalado), nunca por el historial: quien se opone a los perfiles queda fuera de los segmentos, y nunca llegan a un menor.
  • Validador del contenido (largos de Google, enlaces solo a tus dominios, sectores restringidos, la regla del precio de 30 días de la UE, idiomas obligatorios) y aprobación por un segundo administrador de Wallet.
  • Solo a quien dio el consentimiento promocional de cada canal, en su franja horaria local y fuera de los festivos, dentro de los topes de su paquete de política entre canales (Colombia: una promoción al día y un canal a la semana); cada mensaje lleva un enlace de baja de un clic.
  • Cifras: pases alcanzados por canal, guardados y borrados, bajas y compras en la ventana de la campaña; nunca «entregados».
Promociones en el pase
  • Solo para quien aceptó las promociones en Wallet; los demás conservan sus cupones, recompensas y vencimientos.
  • Apple: un campo «Promociones para ti» en el reverso, un strip temporal y una nota cerca de las tiendas, siempre en silencio, y solo promociones que se canjean con el pase o exclusivas de los socios del programa.
  • Google: la campaña como mensaje (con un aviso dentro de la cuota) y su imagen, y las promociones de tus programas como módulos de valor añadido.
  • Las promociones automáticas de Odoo que eliges se muestran mientras están en vigor, y todo sale del pase con una actualización cuando terminan.
Cupones, paquetes y pases de campaña
  • Google (opcional): los cupones del cliente llegan solos al teléfono, vinculados a la tarjeta de fidelización guardada, en ranuras que se reutilizan, nunca más de 50 por tarjeta.
  • Apple: un paquete .pkpasses de hasta 10 cupones y pases de campaña en los enlaces por correo, SMS, WhatsApp y el portal, nunca con saldo; un límite de cupones vivos por cliente (10 por defecto).
  • Pases de campaña para códigos promocionales, promociones automáticas y «compra X y llévate Y»: un pase por cliente con el código de la regla, que se anula al terminar el programa.
Apps de marketing de Odoo y Gmail
  • Comunicaciones de fidelización («al crear» y «al alcanzar») como mensaje silencioso en el pase, por SMS o por WhatsApp.
  • Marketing por correo electrónico: los pases de Wallet como destinatarios de un envío, con filtros sobre la foto y las reglas de las campañas.
  • Automatización de marketing (Enterprise): un paso Wallet que actualiza los pases o envía una campaña de Wallet aprobada.
  • Gmail (opcional): el correo de una tarjeta de fidelización puede ofrecer agregarla a Google Wallet, una vez que Google lo activa para tu remitente.
Analítica e inscripción pública
  • Pases emitidos e instalados (cada pase una vez, iPhone y Apple Watch juntos), bajas, inscripciones, avisos y errores, y compras en la ventana de cada campaña, por día, marca, programa, wallet, país y campaña; sin nombres ni correos.
  • Inscripción pública desde un cartel con QR o una etiqueta NFC en la caja: un formulario con los consentimientos del paquete de política, doble confirmación por correo y antispam propio (formulario firmado, campo trampa, 5 intentos por IP y hora), sin terceros.
  • Captcha opcional de Google reCAPTCHA o Cloudflare Turnstile, por marca.
Niveles y membresías
  • Niveles por programa según el saldo, los puntos ganados en un periodo o, con Partnership, el nivel de partner de la empresa del cliente: nombre, colores e imagen por nivel, una clase de Google Wallet por nivel y un solo aviso, solo cuando el cliente sube.
  • Pases de membresía sin tarjeta, cuyo código es el código de cliente que lee la caja; con Suscripciones (Enterprise), activos, en pausa o anulados según la suscripción.
  • Horario de la membresía, que el iPhone usa para sugerir el pase; la foto del socio solo en Apple Wallet y apagada por defecto.
iOS 27 y App Store Connect
  • Pases póster con tu arte en iOS 27, con el pase clásico detrás para iOS 26 y anteriores, sincronizados por iCloud.
  • Hasta dos Featured Actions bajo el pase: el portal del cliente, la tienda en línea y, en los monederos, Add to Balance hacia la recarga web.
  • Códigos lineales en iOS 27 (EAN-13, Code 39, Codabar, ITF) con el QR detrás; la caja lee los dos.
  • Pass Type IDs y certificados creados y renovados con la API de App Store Connect y una Team key que se borra al terminar; la llave de APNs del equipo como opción experimental.
Quiosco, autopedido y restaurante
  • La página de confirmación del quiosco y del autopedido muestra el QR del pase, o el de la inscripción pública si el cliente no tiene tarjeta; nunca un monedero ni una tarjeta regalo con titular.
  • Al dividir una cuenta, la caja pregunta quién gana los puntos de la parte nueva: el cliente, un pase escaneado, otro cliente o nadie.
Android sin Google Wallet, códigos rotativos y migraciones
  • WalletPasses (opcional, apagado por defecto) para los Android sin Google Wallet, con sus propios avisos y nunca APNs.
  • QR rotativo opcional en Google Wallet que cambia cada 30 segundos y que solo comprueba Odoo: una captura de pantalla deja de servir.
  • Migraciones a un dominio nuevo, a un Pass Type ID de Apple nuevo o de las tarjetas de otro proveedor, con el tablero siguiendo a los dispositivos antiguos.
Recarga web, Apple Pay y Google Pay
  • Recarga del monedero sin iniciar sesión, desde la tarjeta web y desde Add to Balance en iOS 27: el cliente paga el presupuesto en tu portal y el saldo se actualiza solo.
  • Apple Pay y Google Pay con los proveedores de pago de Odoo que los ofrecen, como Stripe, Adyen y Mollie; Apple Pay necesita el dominio verificado en cada base de datos.
  • La tarjeta web de una tarjeta regalo lleva a su producto en tu tienda.
  • Un campo «Número de socio» en el checkout y en el portal que Chrome puede llenar desde Google Wallet; nunca mueve puntos ni saldo.
NFC y alta desde las wallets (apagados hasta que los configuras)
  • NFC de Apple: el pase para los terminales Apple VAS y el alta desde Apple Wallet, que nunca se salta los consentimientos del paquete de política; necesita el certificado NFC que concede Apple.
  • Alta desde Google Wallet: el cliente se inscribe en el programa desde Google Wallet, con el inicio de sesión de tarjetas regalo y las restricciones de guardado con Sign in with Google, cuando Google los activa.
  • Smart Tap: un teléfono Android presenta por NFC su pase de Google Wallet a un lector certificado por Google, que escribe el código de la tarjeta en el Punto de Venta; con tu propio Redemption Issuer y tus llaves, y Odoo nunca guarda la llave privada de un lector. Bounceback, un piloto de Google, a pedido.
  • Incluidos en el módulo y apagados hasta que los configuras: Apple o Google aprueban antes a cada comercio.
Pedidos, eventos, Merchant Center y edad (apagados hasta que los configuras)
  • Pedidos en Apple Wallet para el eCommerce: el cliente sigue su pedido y su entrega en Wallet (exige un Order Type ID y un Merchant ID de Apple Pay).
  • Entradas en Apple Wallet y Google Wallet desde las inscripciones de Eventos, con el horario del evento; apagadas en cada evento hasta que las enciendes.
  • Ventajas de socio en Google Search y Shopping: los atributos de fidelización del feed de Merchant Center (programa, precio de socio y nivel).
  • Verificación de edad con Verify with Wallet (iOS 26, Safari): la página del pase y el alta pública solo preguntan si el cliente tiene la edad que pide su política, con un documento en Apple Wallet, y guardan solo el resultado; para marcas y clientes de Estados Unidos y Japón.
Límites que ponen Apple y Google
  • Actualización. Apple: en segundos o minutos, si el cliente mantiene activas las actualizaciones y las notificaciones del pase; APNs guarda un solo aviso durante 30 días como máximo. Google: cuando el teléfono sincroniza, hasta 24 h; la tarjeta regalo de Google se actualiza sin aviso documentado.
  • Avisos. Ninguno tiene la entrega garantizada ni una hora fija, y el cliente puede apagarlos. Odoo nunca informa «avisos entregados», solo enviados.
  • Cercanía. Es una sugerencia pasiva y silenciosa en la pantalla bloqueada: la decide el sistema y no se puede medir. Apple: texto propio por tienda, sin aviso; hacen falta «Sugerir en la pantalla bloqueada» y la ubicación para Wallet, y el radio es de unos 100 m. Google: el texto, el radio y la frecuencia los pone Google, no admite texto del comercio y el cliente necesita los avisos activados y la ubicación precisa «siempre».
  • Promociones. Apple: siempre en silencio, nunca con aviso, y solo promociones ligadas al pase; si una versión de iOS no muestra el strip temporal, la promoción queda en el reverso. Google: como mucho 2 de los 3 avisos de un pase cada 24 h van a las campañas (el tercero queda para los recordatorios), títulos de menos de 29 caracteres y textos de menos de 40 plegados u 80 desplegados, y los enlaces a apps siguen apagados hasta que Google confirme que no necesitan lista de permitidos.
  • Cupones. Google vincula como mucho 50 pases a una tarjeta en toda su vida, y recibe cada cupón vinculado sin que el cliente pulse su botón. Apple nunca agrupa los cupones: un paquete lleva 10 pases como máximo, y las tarjetas que agrega Gmail nunca se actualizan solas.
  • iOS 27. El póster, las Featured Actions y los códigos lineales necesitan iOS 27; las versiones anteriores muestran el pase clásico con su QR. Los códigos rotativos solo existen en Google Wallet en Android: Apple Wallet, la tarjeta web y el PDF conservan el código de la tarjeta.
  • Pagos. Apple Pay y Google Pay vienen de tu proveedor de pago, en los países donde existen (Colombia sí, Venezuela no). Que Chrome llene el número de socio desde Google Wallet todavía no se ha confirmado en un teléfono.

Capturas de pantalla


Un recorrido por el producto de principio a fin, tomado en una base de demostración con datos de prueba; no aparece ningún cliente real.

Wallet Dashboard
Tablero de Wallet

Empieza aquí: pases vivos, instalaciones en Apple Wallet y Google Wallet, puntos emitidos y canjeados, compras por día y hora, resultados de las campañas y socios por nivel, de los últimos 7, 30 o 90 días o 12 meses. Gráficas con Apache ECharts; solo cifras de grupos, nunca un cliente.

Live preview of the card design
Diseña tu tarjeta con vista previa en vivo

En la marca, el pase de Apple Wallet, el de Google Wallet y el póster de iOS 27 se dibujan mientras cambias colores e imágenes, antes de guardar, con avisos cuando el contraste es bajo o una imagen se va a recortar.

Gallery of ready-made designs
24 diseños listos

Veinticuatro diseños por sector, cada uno con tu propio logo y nombre: un clic fija los colores, la franja, la imagen principal y el póster, y puedes guardar tu propio diseño para tu compañía.

Program tiers and their preview
Programas y niveles

Activa Wallet en un programa de fidelización y dale niveles: cada nivel tiene sus colores e imágenes, con la misma vista previa y los mismos diseños.

Passes
Pases

Cada pase con su programa, cliente, saldo, dispositivos de Apple, guardado en Google Wallet y estado.

A pass
Un pase

Los datos publicados de un pase (saldo, nivel, vencimiento), sus dispositivos de Apple y su objeto de Google, y los botones para enviar su enlace, revocar su tarjeta web o anularlo.

Web card
Tarjeta web en el teléfono

La página del cliente, con los colores y el logo de la marca: saldo, QR y código de barras para la caja, PDF y actividad reciente. Con las cuentas de Apple y Google de la marca, la misma página ofrece Apple Wallet y Google Wallet.

Event ticket
Entrada de evento

La entrada de una inscripción como pase, con la fecha, el lugar y el código que se lee en la puerta.

Campaign
Campañas

Una promoción para los socios de tus programas: su título, texto e imagen, los canales, la audiencia y la aprobación de un segundo administrador.

Campaign results
Resultados de la campaña

Cuántos pases alcanzó cada canal, y las compras y los pases guardados y eliminados en la ventana de la campaña.

Point of Sale
Punto de venta

El cajero elige al cliente y ve los puntos y el saldo del monedero de su tarjeta; el pase se actualiza solo después de la venta.

Health checks
Comprobaciones

Lo que falta o está por vencer en cada marca, en rojo y amarillo, antes de que un cliente lo note: cuentas, certificados, política y contenido. La marca de la demo no tiene cuentas de Apple ni de Google, y sus comprobaciones lo dicen.

Analytics
Analítica

Pases instalados por wallet y mes, y las demás medidas de los pases, como gráfica, tabla dinámica u hoja de cálculo.

Stores
Tiendas

Las tiendas de la marca con sus coordenadas: cada pase lleva las más cercanas a su cliente, para que el teléfono lo sugiera al pasar cerca.

Policy packs
Política por país

Paquetes de política por país con sus versiones y fechas de revisión: consentimiento, avisos, ventanas de envío y textos legales.

Cómo funciona


Del ticket de la caja a la Wallet del cliente, en tu Odoo y con tus cuentas:

  1. Activas Wallet en un programa de puntos, monedero, tarjeta regalo o cupones y le asignas una marca: nombre, colores, imágenes, tiendas, idiomas y paquete de política del país.
  2. El cliente compra en la caja y Odoo suma los puntos o mueve el saldo con el flujo nativo de fidelización.
  3. Tras el pago, el ticket, la pantalla de fin de venta y la pantalla del cliente muestran un QR; el cajero también puede enviar el enlace por correo, SMS o WhatsApp.
  4. El cliente escanea el QR y llega a la página de la marca, que le pide los consentimientos que falten según su país y le ofrece Apple Wallet, Google Wallet o la tarjeta web, según su teléfono y su país.
  5. En iPhone, el pase se descarga desde tu Odoo, firmado con el certificado de tu cuenta de Apple. En Android, tu Odoo crea el pase en Google en ese momento y el cliente lo guarda.
  6. En cada compra o canje, Odoo pone el pase en cola. El publicador rehace la foto del pase y, si cambió, avisa a Apple para que el iPhone descargue la versión nueva y actualiza el pase en Google.
  7. Para canjear, el cajero escanea el código del pase; Odoo valida el saldo y aplica la recompensa como siempre.
Sin servidor central. Cada comercio usa su propia cuenta de Apple Developer, su emisor de Google Wallet y su Odoo con HTTPS. GRUPO MI ERP no está en medio y no recibe datos.

Qué ve el cliente en iPhone y en Android


iPhone · Apple Wallet
  • Tarjeta con el logo, los colores y el nombre de la marca; los puntos o el saldo arriba, y el código QR o Code128 que lee la caja.
  • Los puntos que vencen pronto, con su fecha y hora local; la próxima recompensa y lo que falta; la vigencia y los últimos 5 movimientos.
  • En el reverso: términos, contacto del comercio, enlaces a la tienda, a sus tiendas, a /my y a la tarjeta web, y cómo refrescar el pase.
  • Un aviso del sistema cuando cambian los puntos («Tienes 1.250 puntos»); en monedero y tarjeta regalo, sin importe.
  • Cerca de una de sus tiendas, una sugerencia silenciosa en la pantalla bloqueada, si iOS decide mostrarla.
  • El pase también se ve en el Apple Watch, sin los avisos de cambio. El iPad no guarda pases de fidelización: la página muestra un QR para abrirlo en el iPhone.
  • En iOS 27: tu arte como póster, hasta dos botones bajo el pase (portal, tienda o Add to Balance) y, si lo eliges, un código lineal.
Android · Google Wallet
  • Tarjeta de fidelización, tarjeta regalo u oferta, con el logo, el color y las imágenes de la marca y el código QR.
  • Los puntos o el saldo y la vigencia en la tarjeta; en el detalle, los últimos movimientos, los puntos que vencen, los términos y el contacto, con enlaces a /my, a la tienda, a sus tiendas, a la privacidad y a la tarjeta web.
  • Los cambios aparecen cuando el teléfono sincroniza, hasta 24 h después; como mucho 3 avisos por pase cada 24 h, y la tarjeta regalo se actualiza sin aviso.
  • Cerca de una tienda, Google puede mostrar un aviso con su propio texto.
  • Monedero y tarjeta regalo piden desbloquear el teléfono, y nadie más puede guardar la tarjeta del cliente.
  • Si lo activas, un QR que cambia cada 30 segundos.
  • Requiere Android 9 o posterior con los servicios de Google Play.
Sin wallet. Huawei con HarmonyOS, Android en un país sin Google Wallet o cualquier otro teléfono: tarjeta web permanente con QR, Code128 y saldo, que se ancla a la pantalla de inicio, y PDF. La caja la lee igual.

Para cualquier país


Idiomas
  • Textos del pase, la página, la tarjeta web, el PDF, el correo, el SMS, WhatsApp y el ticket incluidos en español, inglés, portugués de Brasil y francés.
  • Cualquier otro idioma activo se traduce desde Odoo, en Ajustes › Traducciones, sin tocar el código.
  • Cada pase en el idioma de su cliente, también en árabe y otros idiomas de derecha a izquierda.
  • Si falta la traducción de un idioma que exige el país (con sale_loyalty_delivery, también la descripción del envío gratis), el pase no se emite y el tablero lo dice. Interfaz de Odoo en inglés y español.
Monedas, fechas y horarios
  • Importes en la moneda de cada programa y con su formato: el yen sin decimales, el dinar kuwaití con tres.
  • Fechas y horas en la zona horaria del cliente, con horario de verano.
  • El vencimiento se muestra con fecha y hora local: en Bogotá, los puntos que vencen el 12 de noviembre desaparecen ese día a las 19:00, y el pase lo dice.
  • Multicompañía y multimarca: cada marca firma con el equipo de Apple de su compañía o de una compañía matriz, y hay un emisor de Google por compañía y país.
Países
  • Apple Wallet: la cuenta de Apple Developer del comercio debe estar en un país donde Apple admite inscripciones; Apple no inscribe comercios de países embargados por EE. UU.
  • Google Wallet: solo en los países de la lista oficial de Google. No existe, entre otros, en China, Rusia, Turquía ni Corea del Sur.
  • La tabla de países viene con el módulo y el comercio puede corregirla.
  • Donde no hay wallet, la tarjeta web es el respaldo universal.
Política por país
  • 12 paquetes: genérico, Colombia, Venezuela, México, Perú, Chile, Argentina, Brasil, Unión Europea (con una regla para Francia), EE. UU. (con reglas para California y Washington), Canadá (con reglas para Quebec y Ontario) e India.
  • Consentimiento por canal y finalidad, franjas horarias, festivos, topes, edades, idiomas obligatorios, plazos de conservación y textos legales.
  • Si falta un requisito del paquete, no se emite ni se avisa.
  • Son plantillas sin revisión legal: el comercio las marca como revisadas con su asesor.
  • Una corrección llega como versión nueva en borrador que pones en vigor: una actualización nunca cambia un paquete que editaste y propone la versión nueva en cada marca.

Requisitos


Odoo y servidor
  • Odoo 20.0 Enterprise en Odoo.sh u on-premise. No funciona en Odoo Community ni en Odoo Online.
  • Dominio público con HTTPS y una base de datos por dominio, o un proxy que en /mierp_wallet/ y /w/ fije la base (X-Odoo-Database) y la IP real del cliente (X-Forwarded-For), con dbfilter exacto, proxy_mode y web.base.url.freeze.
  • Cron activo (--max-cron-threads de 1 o más).
  • Librería Python httpx[http2] y, para completar los teléfonos locales en SMS y WhatsApp, phonenumbers.
  • Firewall o CDN que dejen pasar a Googlebot y a Google-Valuables hacia los callbacks y las imágenes.
  • Apps de Odoo: es un solo módulo, y al instalarlo se instalan todas las apps con las que trabaja, si aún no están: Fidelización, Punto de Venta (con Autopedido y Restaurante), Ventas, eCommerce, Inventario y Entregas, Eventos, SMS (enviar exige créditos IAP), Marketing por correo electrónico, Partnership y, de Odoo Enterprise, WhatsApp, Automatización de marketing y Suscripciones. Solo configuras las que usas.
  • Para la recarga web: un proveedor de pago de Odoo; Apple Pay y Google Pay necesitan uno que los ofrezca, y Apple Pay el dominio verificado en cada base de datos.
Cuentas de Apple y Google
  • Apple Developer Program de organización, a nombre del comercio titular de la marca (o de una licenciataria con autorización escrita): USD 99 al año, que se pagan a Apple, y número D-U-N-S. Las ONG y las entidades educativas y de gobierno pueden pedir la exención de la cuota.
  • Un Pass Type ID por familia de pase y uno de pruebas (cuatro por marca, un quinto para los pases de campaña y un sexto para las membresías), con certificados que se renuevan cada año.
  • Un emisor de Google Wallet por país, con su perfil de empresa y de pagos, y un proyecto de Google Cloud con la Google Wallet API y una cuenta de servicio con su llave.
  • Google revisa el emisor y las clases de pase antes de publicarlos.
Dependencias de Python: en Odoo.sh, añade httpx[http2] al requirements.txt de la raíz de tu repositorio; on-premise, pip install -r mierp_wallet/requirements.txt.

Datos y privacidad


Nada sale hacia Apple ni Google hasta que un administrador de la marca (un administrador de Ajustes que también lo es de Wallet) acepta en Odoo el envío de datos; la aceptación queda registrada con su usuario y la fecha.

  • A Apple: tu Odoo solo envía a APNs el token del dispositivo, el identificador del tipo de pase (en los pedidos de Apple Wallet, el Order Type ID) y un mensaje vacío. El iPhone descarga el pase directamente de tu Odoo y le envía el identificador del dispositivo, el token de push y registros técnicos. Si el cliente usa iCloud, Apple sincroniza el pase entre sus dispositivos.
  • A Google: la clase del programa (nombre y logos, colores, imágenes, tiendas destacadas, textos y enlaces) y, solo cuando el cliente pulsa «Agregar», su pase: id, código de la tarjeta, saldo o puntos, vigencia, puntos por vencer, recompensas y últimos movimientos, mensajes, tiendas, los términos y el contacto del emisor y, si el programa lo activa, el nombre de pila. Google puede usar esa información para prestar y mejorar sus servicios, y avisa a tu Odoo cuando el cliente guarda o borra el pase.
  • Al IAP de Odoo, por los SMS (opcional): el teléfono y el texto con el enlace (del pase, de una campaña o el que detiene las promociones) pasan por el servicio IAP de Odoo S.A. y sus proveedores.
  • A Meta, por WhatsApp (opcional, Enterprise): el teléfono, la plantilla, sus textos y el enlace pasan por la API de Meta de la cuenta del comercio.
  • Por correo: el enlace a la página del pase, las campañas y la confirmación de la inscripción salen por el servidor de correo saliente de tu Odoo. Con la opción de Gmail, el correo de una tarjeta de fidelización lleva el nombre de la marca y del programa y el código de la tarjeta en un formato que Gmail lee para ofrecerla en Google Wallet.
  • A un proveedor de captcha (opcional, por marca): con Google reCAPTCHA o Cloudflare Turnstile en la inscripción pública, el navegador del visitante carga su script y le envía su IP; nómbralo en tu aviso de privacidad.
  • A WalletPasses (opcional, apagado por defecto): los tokens de push de los Android que usan su app y el identificador del tipo de pase; solo se enciende cuando tus avisos de privacidad lo nombran.
  • A tu proveedor de pago (recarga y tienda): el pago y los datos que pide tu proveedor, como en cualquier pago de Odoo.
  • Verificación de edad (opcional, Verify with Wallet): el iPhone del cliente solo le dice a tu Odoo si tiene la edad pedida; Odoo guarda el resultado, el tipo de documento y su emisor, nunca el documento ni la fecha de nacimiento, y no envía nada a Apple.
  • A GRUPO MI ERP: nada. No hay telemetría.

Nunca se envían documentos de identidad ni la ubicación del teléfono, y la página del pase no usa cookies ni recursos de terceros. El responsable de los datos es cada comercio; los consentimientos quedan registrados por canal y finalidad, con la versión del texto, el idioma y la hora.

Supresión: el pase se anula y se retiran los datos personales que controla el comercio. Google conserva el pase inactivo y sin nombre, el pase no desaparece del teléfono hasta que el cliente lo borra y las copias de iCloud las guarda Apple. El registro mínimo que queda en Odoo se borra a los 30 días.
Política de privacidad: https://www.mi-erp.app/wallet/privacidad

Lo que no hace


No garantiza que los avisos lleguen ni a qué hora; el cliente puede apagarlos.
La cercanía es una sugerencia pasiva y silenciosa que decide el sistema y no se puede medir.
No hace que Google muestre un cambio antes de que el teléfono sincronice: puede tardar hasta 24 h.
No borra el pase del teléfono: lo borra el cliente.
No imprime en un ticket un monedero ni una tarjeta regalo con titular, y un pedido que cobra una caja distinta de la que lo creó no tiene QR sin conexión.
Los paquetes por país son plantillas sin revisión legal; no son asesoría jurídica.
Nunca hace publicidad con un aviso de Apple: las promociones de Apple son silenciosas, en el reverso del pase. En Google, una campaña avisa como mucho dos veces por pase cada 24 h, y solo a quien aceptó las promociones en Wallet.
La tarjeta web y el PDF no muestran las promociones del pase, y una promoción que alcanza su límite de usos con las ventas sigue en los pases hasta su actualización siguiente.
La analítica solo cuenta lo que Odoo conserva: al purgarse los eventos, se van con ellos las bajas, los avisos y los errores antiguos.
No funciona en Odoo Online ni en Odoo 19 o anteriores.
No cobra por sí mismo, y no puede recargar una tarjeta regalo en línea: Odoo vende una nueva. El número de socio nunca mueve puntos, saldo ni titularidad.
No incluye lo que exige una app nativa (Tap to Pay, Tap to Share), ni pases de embarque, ni pases de Huawei Wallet o Samsung Wallet: esos clientes usan la tarjeta web.

Detalles técnicos


  • Un solo módulo, mierp_wallet: Punto de Venta, Ventas, eCommerce, SMS, WhatsApp, Marketing por correo electrónico, Automatización de marketing, Partnership, Suscripciones, Autopedido y Restaurante van dentro; no hay puentes que instalar.
  • También van dentro, apagados hasta que la marca configura cada uno: NFC de Apple y el alta desde Apple Wallet, el alta desde Google Wallet, Smart Tap, los pedidos en Apple Wallet, las entradas de eventos, los precios de socio de Merchant Center y Verify with Wallet.
  • Dependencias: loyalty, certificate, privacy_lookup, pos_loyalty, pos_self_order, pos_restaurant, sale_loyalty, website_sale_loyalty, stock_delivery, event, sms, mass_mailing, partnership y, de Odoo Enterprise, whatsapp, marketing_automation y sale_subscription; Python httpx y h2, y, opcional, phonenumbers para SMS y WhatsApp.
  • Modelos principales: mierp.wallet.brand, mierp.wallet.pass, mierp.wallet.apple.team, mierp.wallet.apple.pass.type, mierp.wallet.google.issuer, mierp.wallet.google.class, mierp.wallet.location, mierp.wallet.policy.pack, mierp.wallet.consent, mierp.wallet.job, mierp.wallet.campaign, mierp.wallet.tier, mierp.wallet.migration y el informe mierp.wallet.analytics; extiende loyalty.program, loyalty.card, loyalty.history y res.partner.
  • Apple: .pkpass firmado en Odoo (PKCS#7 con la cadena WWDR G4), web service de Wallet y APNs por HTTP/2, con una conexión por certificado.
  • Google: Google Wallet API por REST, JWT RS256 firmados con las llaves de certificate, callbacks firmados (ECv2) y un límite compartido de 20 peticiones por segundo por proyecto.
  • Cola de salida con un solo cron publicador, reintentos con espera y disyuntor; cada pase guarda el hash de su foto: si nada cambió, no hay push ni actualización.
  • Seguridad con ir.access.csv de Odoo 20: grupos Usuario y Administrador de Wallet; credenciales solo para el administrador del sistema; el cajero no lee modelos de Wallet.
  • Licencia OPL-1: código legible, sin ofuscar, sin claves de activación ni telemetría. Interfaz en inglés, español, portugués de Brasil y francés.

Nuestros servicios / Our services


Fuera de la tienda: alta asistida de tu marca en Apple y Google, con contrato escrito, renovaciones gestionadas y desarrollos a medida.

Outside the store: assisted onboarding of your brand with Apple and Google under a written contract, managed renewals and custom development.

Contáctanos / Contact us


Obtendrás asistencia gratuita durante 60 días por cualquier error o problema.

You will get free support for 60 days for any bug or issue.

Para consultas o soporte / For questions or support: [email protected]