兴趣爱好Spin by OXXO API Integration
Connecting Mexico's Largest Digital Wallet to Your Fintech Stack
============================
INTRODUCTION
--------------------
Spin by OXXO-Tu Cuenta Digital has emerged as one of Mexico's most powerful digital finance platforms, backed by retail giant FEMSA and operated by Compropago S.A. de C.V. as a fully authorized IFPE (Institución de Fondos de Pago Electrónico). By Q4 2024 the wallet had reached 13.1 million active users, and by Q2 2025 it was processing approximately 73.7 million transactions per month — a 28.9% year-over-year growth rate that signals the platform's central role in Mexico's rapidly evolving open finance ecosystem.
For developers, fintech operators, and enterprise teams, this volume represents an extraordinary data asset: SPEI bank transfers, Visa card authorizations, CoDi QR collections, OXXO cash-in and cash-out events, bill payments, airtime top-ups, and Spin Premia loyalty point movements — all flowing through a single wallet with 24,000+ physical cash access points across the country.
OpenFinance Lab delivers production-ready API integrations for Spin by OXXO, enabling teams to connect this data to reconciliation pipelines, remittance corridors, accounting platforms, risk engines, and CRM systems. Pricing starts at $300 for source-code delivery, with a pay-per-call hosted endpoint option for usage-based workloads. Full details and contact information are available at https://openfinance-lab.com/spin-by-oxxo-tu-cuenta-digital.html
============================
SUPPORTED API FEATURES
--------------------
The Spin by OXXO integration surface covers the full lifecycle of a Mexican digital wallet — from onboarding and identity verification through every payment rail the platform supports. Below is a summary of the core API capabilities delivered by OpenFinance Lab.
Account Login and KYC Mirror
Server-side OAuth-style authentication using phone number, password
and device fingerprint. Surfaces KYC tier, CURP verification status
and INE onboarding state for downstream compliance workflows.
Statement and Transaction Endpoints
Paginated, date-filtered exports of SPEI inbound and outbound
transfers, CoDi QR collections, Visa card authorizations and OXXO
cash deposit and withdrawal events. Available as JSON, Excel or PDF.
SPEI and CoDi Payout Initiation
Programmatic SPEI transfers and CoDi pull-payment requests with
full webhook support for clave de rastreo delivery, settlement
state changes and reversal notifications aligned to Banxico rails.
Visa Card Transaction Data
Per-authorization records including merchant name, MCC code,
amount, currency and FX details for both virtual and physical
Visa cards linked to Spin accounts.
OXXO Cash Event Feeds
Store-level deposit and withdrawal events tied to individual
ticket identifiers — critical for AML monitoring, SME treasury
reconciliation and cash-flow analytics at scale.
Spin Premia Loyalty Export
Accrual and redemption records from the triple-points engine,
joinable with Visa authorization data for campaign attribution
and partner-brand CRM enrichment.
Cross-Border Remittance Webhooks
US-to-Mexico inbound remittance flows using SPEI rails and
partner infrastructure, including FX conversion logging,
beneficiary KYC checks and reconciliation reports modeled
on the 2025 Kira-Spin integration.
============================
USE CASES AND APPLICATIONS
--------------------
[1] SME Accounting Reconciliation
------------
Pull nightly SPEI inbound/outbound and Visa card authorizations
from Spin by OXXO business wallets
Normalize transaction records into a common ledger schema
Push structured rows directly into Contpaqi, Aspel or QuickBooks
via each tool's native import API
Fully aligned with the upcoming CNBV Open Finance technical
standard for read-only data access
Reduce manual bookkeeping overhead for Mexican SMEs using Spin
as their primary operating wallet
[2] US-to-Mexico Remittance Corridor
------------
Look up beneficiary Spin accounts by phone number or CLABE
Log FX conversion rates per remittance transaction
Initiate SPEI deposits into Spin wallets from US-side operators
Deliver clave de rastreo webhook callbacks to sender-facing apps
for real-time receipt generation
Match the architecture of the 2025 Kira-Spin partnership,
enabling diaspora finance products at production scale
[3] Embedded Finance for Retail Chains
------------
Generate CoDi QR codes for supplier invoice collections
Initiate SPEI payouts to vendor accounts from Spin business
sub-accounts
Reconcile daily OXXO store cash-in events against expected
ticket totals and invoice identifiers
Build automated three-way match between purchase orders,
invoices and Spin payment confirmations
[4] Loyalty and CRM Enrichment
------------
Join Visa card authorization events with Spin Premia accrual
records to identify which transactions triggered which rewards
Attribute triple-point campaigns to specific merchant categories
using MCC codes
Push enriched attribution data to Segment, mParticle or a
customer data warehouse for downstream analytics
Support consumer brand sponsors with granular ROI measurement
on Spin Premia co-marketing investments
[5] AML and Compliance Risk Monitoring
------------
Receive near-real-time webhook events for cash deposits and
withdrawals across 24,000+ OXXO store locations
Monitor SPEI velocity per user with structured fields for
amount, store ID, device fingerprint and geolocation
Feed normalized event streams into rule engines such as
Sardine or Unit21 for automated SAR flagging
Maintain KYC tier context per user for CNBV and SAT-style
transaction threshold reporting
============================
BENEFITS AND ADVANTAGES
--------------------
Access to Mexico's Largest Cash-Digital Bridge
Spin by OXXO uniquely connects digital wallet operations
with physical cash transactions at 24,000+ OXXO locations —
a data richness no purely digital wallet can match.
Full SPEI and CoDi Rail Coverage
Both Banxico payment rails are supported end-to-end:
SPEI for inter-bank transfers and CoDi for QR-based
pull payments, with webhook settlement confirmations.
Compliance-First Architecture
Every integration is scoped under CNBV/Banxico Fintech Law
guidelines, IFPE rules and the forthcoming Open Finance
technical standard. Consent records, audit logs and data
minimization are included by default.
Rapid Time-to-First-Delivery
Login, balance and statement endpoints are typically
delivered in 5 to 12 business days. Full SPEI/CoDi payout
flows and remittance webhooks add 1 to 3 weeks depending
on third-party approvals.
Flexible Engagement Models
Choose between source-code delivery (from $300, paid on
acceptance) or a pay-per-call hosted API with no setup fee.
Both models can be combined for phased rollouts.
Multi-Language SDK Support
Runnable source is delivered in Python, Node.js or Go,
with OpenAPI 3.1 specifications, Postman collections and
integration test suites included in every delivery.
Broad Mexican Fintech Ecosystem Compatibility
Teams using Spin by OXXO frequently also need harmonized
data from Mercado Pago, Cuenca, Fondeadora, Nu Mexico,
Klar, Albo or BBVA Wallet. OpenFinance Lab has integration
experience across all major Mexican wallet and neobank
platforms for unified multi-source reporting.
============================
SUBSCRIPTION PLANS
--------------------
OpenFinance Lab offers two primary engagement models for Spin by OXXO API access:
Source Code Delivery
------------
From $300 per integration scope
Full runnable API source delivered in Python, Node.js or Go
Includes OpenAPI 3.1 spec, Postman collection, test harness
and compliance notes for CNBV/Banxico and Llave MX alignment
Payment due only on acceptance — no upfront risk
Best for teams that need in-house operation and ownership
of the integration layer
Pay-Per-Call Hosted API
------------
No setup fee, no minimum commitment
Call managed Spin by OXXO endpoints with a bearer token
Pay only for the API calls your product actually makes
Best for early-stage prototypes or low-volume use cases
where provisioning infrastructure is premature
Both models can be layered: prototype quickly on the hosted
endpoint, then take source-code delivery when ready to operate
the integration internally at scale.
============================
CONCLUSION
--------------------
Spin by OXXO-Tu Cuenta Digital is not just a consumer wallet — it is a data-rich infrastructure layer connecting 13.1 million Mexican users to SPEI transfers, Visa card transactions, CoDi QR payments, OXXO cash events and cross-border remittances within a single, regulated IFPE environment. For fintech operators, accounting platforms, remittance providers and enterprise compliance teams, the value of accessing this data programmatically is substantial.
OpenFinance Lab's production-ready integration service removes the technical barrier. Whether your team needs nightly SME reconciliation feeds, real-time AML event streams, remittance corridor infrastructure or loyalty attribution pipelines, the delivered source code and hosted API options provide a compliant, documented and tested path to production.
To discuss scope, request a quote or review deliverable details:
--------------------
2026 OpenFinance Lab · OpenData and OpenFinance · compliant interface services
Spin by OXXO-Tu Cuenta Digital is operated by Compropago S.A. de C.V. IFPE (FEMSA group).