Wallet Provider (WSP)
What is a Wallet Provider (WSP - Wallet Provider)?
The Wallet Provider (WSP) is the merchant-controlled middleware that enables your customer’s mobile app to receive a Wallet payment request during an in-store checkout.
Think of the Wallet Provider as the messenger between the Aera Wallet Infrastructure and the customer’s Mobile App (DPA) — triggered during QR-based transactions.
It does not initiate the payment. It does not process the payment. It simply ensures that the right user receives the right payment request — instantly, securely, and in the correct context.
How It Fits Into the Wallet Payment Flow
Here's how the Wallet Provider fits into the bigger picture:
-
Merchant Store (ECR) initiates the transaction
-
PSP receives it and forwards it to
-
Aera Wallet Infrastructure
-
Wallet Infrastructure sends the transaction to the Wallet Provider, which:
- Identifies the user session
- Routes the transaction to the correct device (Mobile App)
-
The user receives the payment request in their app (Mobile App)
-
User confirms → Wallet Infrastructure → PSP → Acquirers → PSP → Merchant Store completes checkout
The Wallet Provider does not need to touch sensitive data, talk to the Wallet Infrastructure.
What the Wallet Provider Actually Does
| Function | Owned by Wallet Provider |
|---|---|
| Receives transaction payload from the Wallet Infrastructure | ✅ |
| Delivers it to the Mobile App (customer's app) | ✅ |
| Register and handle what customers have registered a Wallet | ✅ |
| Keep track of what payment method each registered Merchant Store allows | ✅ |
| Handles session/device lookup | ✅ |
| Ensures transaction reaches correct user | ✅ |
| Interacts with Merchant Store or PSP | ❌ Never |
| Signs or processes the transaction | ❌ Never |
Why Is the Wallet Provider Necessary?
The Wallet Provider creates a secure, merchant-specific layer that:
- Allows only your users to receive your checkout requests
- Routes the transaction to the right person based on session ID or loyalty context
- Ensures the Wallet stays decoupled from the POS/PSP logic (Point-of-sale / PSP logic)
- Keeps all sensitive processing within the Wallet backend (PCI-DSS safe)
The Wallet Provider is merchant-specific and scoped — it ensures that your customer, not someone else's, sees your payment requests.
Your Responsibilities as a Merchant
If you operate a Wallet Provider (or work with a vendor that does), you’ll need to:
- Maintain the Wallet Provider endpoint (Aera provides a reference implementation)
- Map transactions from the Wallet Infrastructure to the correct Mobile App session
- Handle timeouts, retries, and cancellations locally
- Align with Aera on the supported payment methods, brands, and contexts
Aera does not host the Wallet Provider — you (or your provider) do.
Real-World Analogy
Think of the Wallet Provider like a mailroom at your company:
- Wallet Infrastructure drops off an envelope (payment request)
- The mailroom (Wallet Provider) knows which desk (device & Mobile app) to deliver it to
- The customer (user) reads and signs it (confirms payment)
- The signed response is sent back via Aera to the origin (Merchant Store)
📎 What’s Next?
Updated about 2 months ago
