About this plugin
Topomer extends WooCommerce with two main capabilities:
- Promo code management (automatic and manual)
- A Topomer payment flow that lets eligible customers pay with their Topomer balance
The plugin validates customer tokens through Topomer services, calculates discount rules from remote price intervals, and updates balances after successful checkout.
Features
- Automatic promo code generation based on cart total
- Manual promo code creation and management from the admin area
- Dynamic discount percentage based on configured price intervals
- WooCommerce checkout integration
- Topomer token validation through API
- Customer balance display at checkout
- Balance consumption and synchronization after successful payment
Requirements
- WordPress 5.0+
- WooCommerce installed and activated
- PHP 7.4+
Setup
- Confirm WooCommerce is active.
- Configure your Topomer settings and API-related options.
- Verify promo intervals and manual promo settings.
- Test checkout using a valid Topomer token.
External Services
com) for core functionality. Without these services, token validation, balance handling, and some promo/payment logic will not work.
Service Provider
- Provider: Topomer
- Service base domain: files-pub.com
- Terms of service: https://topomer.com/terms
- Privacy policy: https://topomer.com/privacy
Endpoints, Data Sent, and Purpose
- Token verification endpoint
com/api/plugin/users/get-by-token
* Purpose: Validate customer token and retrieve account data.
idTopomer=TOKEN.
* Data sent: Token value (URL parameter).
- Price intervals endpoint
com/api/interval-prix
* Purpose: Retrieve discount intervals used for dynamic promo calculation.
* Trigger: Cart/checkout logic when discount rules are needed.
* Data sent: No customer personal data.
- Balance update endpoint
com/api/plugin/users/update-solde
* Purpose: Update user balance after successful payment.
* Trigger: After order completion/payment processing.
* Data sent: Token, updated balance amount, user ID.
- Token expiration endpoint
com/api/plugin/users/update-expired
* Purpose: Mark a token as used/expired.
* Trigger: After token usage or validation workflow.
* Data sent: Token, expiration status.
- Personal shopper balance endpoint
com (Topomer internal endpoint)
* Purpose: Retrieve available shopper balance for payment checks.
idTopomer=ID and during checkout.
* Data sent: Personal shopper ID and authentication token in headers.
- Promo code management endpoints
com (Topomer internal endpoints)
* Purpose: Create/update promo codes from admin actions.
* Trigger: Admin creates or updates promo definitions.
* Data sent: Promo details (code, percentage, type, and ID for updates).
- Order processing endpoint
com (Topomer internal endpoint)
* Purpose: Create/process order records after payment.
* Trigger: After successful payment.
* Data sent: Order data (order ID, customer info, items, totals, payment method).
- Authentication endpoint
com (Topomer internal endpoint)
* Purpose: Obtain access token for API requests.
* Trigger: Plugin authentication flow.
* Data sent: Authentication credentials.
Credits
Developed by Topomer.