PlanetPoints API
PlanetPoints API is a turnkey API solution that enables any application to reward users for healthier and more sustainable choices.
By embedding PlanetPoints into your experience, you can deliver purpose-driven engagement that deepens loyalty and differentiates your offering - without the cost or complexity of building a rewards system from scratch.
The integration is intentionally low-lift. Our hosted pages and secure webhooks handle the heavy lifting of data capture, item-level scoring, and points management, giving partners a fast, compliant way to launch item-level rewards at scale.
Why PlanetPoints?
Purpose-Driven Differentiation
Stand out by rewarding customers for choices that matter - healthier products, lower-impact items, and conscious consumption.
Zero Liability
Reewild manages all reward fulfillment, redemption infrastructure, and points liability. Your only responsibility is enrollment and validating relevant transactions or tracking events.
Seamless Integration
PlanetPoints integrates through simple REST APIs with hosted pages that handle data capture and processing for you - no need to build OCR, logging flows, or scoring logic.
Product-Level Insights
Access SKU-level visibility into user behaviour, giving you insight into not just where users shop, but what they buy and consume.
How It Works
The integration follows a simple four-step flow:
1. User Enrollment
When a customer opts into PlanetPoints through your app, you call our enrollment API with basic user information. We return secure access tokens that authorize all subsequent API calls.
Learn more about enrollment →
2. Tracking & Data Capture
In your app, you can prompt users to either submit purchase data or log meals based on your use case. Both flows use Reewild’s hosted web experience, which handles data capture and processing so you don’t need to build or maintain your own UI.
Learn more about receipt scanning →
3. Scoring & Points Awarding
Our backend processes the submitted data, maps items to our product database, determines health and carbon ratings, and awards points accordingly. You’ll be notified of all scoring outcomes via webhooks.
Learn more about scoring methodology →
4. Summary & Data Retrieval
Your app can query a user’s PlanetPoints summary (available points, lifetime points, impact metrics) and itemized history - whether generated from receipts or manually tracked items - via our APIs. This data can power tiles, summaries, detailed breakdowns, or fully custom experiences.
Learn more about retrieving data →
Integration Architecture
Security & Compliance
Authentication
All API calls require OAuth 2.0 Bearer token authentication. Tokens are issued during enrollment and can be refreshed as needed.
Data Minimization
We only collect the minimum data necessary:
- User identifiers (name, email, your internal user reference)
- Transaction metadata (merchant, amount, timestamp, authorization code)
- Receipt images (temporarily stored for processing, then deleted)
No Sensitive Data Storage
- No PAN (Primary Account Number) is transmitted or stored
- No full card details - only last 4 digits for transaction matching
- All data transmitted over TLS 1.2+
What You Need to Get Started
- API Credentials - Create Sandbox application at Reewild Developer Console and test with sandbox credentials and Contact Reewild team to receive your Live application
client_idandclient_secret - Webhook Endpoint - Provide a secure HTTPS endpoint to receive real-time event notifications
- User Consent Flow - Implement a simple opt-in UI in your app
- Hosted Pages Integration - Embed our hosted pages solution for user enrollment flow and receipt scanning flow (similar to embedding Stripe Checkout)
Next Steps
Enroll Users
Learn how to register users and obtain access tokens
Scan Receipts
Integrate the hosted pages experience
API Reference
Explore the complete API documentation
Scoring Methodology
Understand how points are calculated
Questions?
Our integration team is here to help you succeed. Reach out to info@reewild.com for:
- Technical support during implementation
- Custom integration requirements
- Pilot program discussions
- Partnership opportunities