兴趣爱好============================
Advance - Adelanta Tu Pago API
Sync Colombia's earned-wage advance ledger via consented interface integration
============================
INTRODUCTION
--------------------
Advance - Adelanta Tu Pago is a Colombian earned-wage access application
published by Advance your pay Colombia S.A.S., serving over 200,000 employees
across employer-sponsored workforces nationwide. Unlike a credit line, every
advance request settles against a real payroll cycle — making its server state
one of the most valuable financial data objects in the Latin American fintech
space.
The integration target is not a simple balance. It is a living ledger:
how much a worker can draw at any point in the pay period, what has
been requested, what is scheduled, and what the next payroll run will
deduct. For HR platforms, financial-wellness tools, and payroll
reconciliation systems operating in Colombia, synchronizing this
ledger unlocks capabilities that would otherwise require rebuilding
the entire salary-advance engine from scratch.
Consented access to the Adelanta Tu Pago advance ledger is delivered
via authorized interface integration of authenticated worker-session
traffic, supplemented by Colombia's open-finance consent rail
(Decreto 1297 de 2022) for the linked disbursement bank account.
The data regime is governed by Colombia's Ley 1581 de 2012 (Habeas
Data), supervised by the Superintendencia de Industria y Comercio.
This page covers supported API data domains, real-world use cases,
integration advantages, and how to get started.
============================
SUPPORTED API FEATURES
--------------------
The Advance - Adelanta Tu Pago integration exposes the full authenticated
surface of the worker portal and mobile app (Android and iOS), mapped
through consented session traffic into a clean, normalized API.
Real-time eligibility lookup — live "available to advance" figure
recomputed continuously as the pay period elapses, keyed to the
employer's monthly or biweekly cycle
Advance request lifecycle — full create/read/status pipeline for
salary advance requests, including disbursement reference and
processing state
Scheduled advance data — advance schedules programmed for chosen
dates, with recurrence and amount fields available for cash-flow
forecasting
Repayment and deduction tracking — per-cycle deduction records
showing amount owed, deduction date, and settlement state against
the next payroll run
Disbursement event feed — transfer confirmations to the worker's
payroll bank account, with masked account identifier and event
timestamp (funds typically settle within 1-2 hours)
Ancillary spend stream — mobile top-ups, data packages, bill
payments, streaming subscriptions, and transit reloads captured
as a categorized spend layer separate from advance flows
Worker and employment profile — employer-linked identity fields
including pay cycle (monthly or biweekly) and payroll account
reference for HR system matching
--------------------
All seven data domains are accessible through a single authenticated
session integration. An OpenAPI/Swagger spec, normalized schema,
runnable source in Python and Node.js, and automated lifecycle tests
are included in the delivered package.
============================
USE CASES & APPLICATIONS
--------------------
[1] HR AND BENEFITS PLATFORM INTEGRATION
------------
Embed a live "available to advance" figure directly inside an HR or
benefits portal without rebuilding the salary-advance engine.
Pull the real-time eligibility amount from the Adelanta Tu Pago
API and surface it inside an existing employee dashboard
Trigger advance requests from within the HR platform using the
consented session, reducing context-switching for workers
Sync employment profile and pay-cycle metadata for identity
matching across benefit systems
Display request status and disbursement confirmation inside the
same interface workers already use for payroll and HR tasks
[2] FINANCIAL WELLNESS AND PAYROLL RECONCILIATION
------------
Give workers and finance teams a true-net-pay view by reconciling
advances and deductions against the full payroll run.
Mirror advance requests and pending deductions into a financial-
wellness dashboard so workers see actual take-home pay for the
month
Reconcile disbursement events against payroll deduction records
to surface any missed-cycle cases before they affect reporting
Flag in-flight advances that are disbursed but not yet deducted,
preventing double-counting in net-pay calculations
Provide per-employee advance history for HR analytics and
financial coaching workflows
[3] EMPLOYER PAYROLL COST-CENTER REPORTING
------------
Export ancillary spend data alongside advance records for internal
benefit-budget reporting across cost centers.
Separate mobile top-up, bill payment, and subscription spend from
salary-advance flows using the dedicated ancillary spend stream
Aggregate ancillary transactions by cost center or department for
benefit allocation reporting
Schedule automated exports for finance team reconciliation cycles
Map spend categories to internal GL codes via the normalized schema
[4] COLOMBIA OPEN-FINANCE PRODUCT DEVELOPMENT
------------
Build open-finance products targeting Colombia's employer-sponsored
workforce under Decreto 1297 de 2022 and Ley 1581 de 2012.
Combine the Adelanta Tu Pago advance ledger with the linked payroll
bank account data via Colombia's open-finance consent rail for end-
to-end cash-flow visibility
Develop consent-based data pipelines that comply with Habeas Data
requirements and SIC supervision standards
Integrate alongside peer platforms (Symplifica, Runa, Minu) within
a unified earned-wage access layer for the Latin American market
Prove field-level mapping against real employee sessions before
scaling to employer-wide deployments
[5] UNIFIED EARNED-WAGE ACCESS AGGREGATION
------------
Build a multi-source earned-wage ledger that speaks to Adelanta Tu
Pago alongside global EWA platforms in a single normalized schema.
Slot Adelanta Tu Pago beside Minu (Mexico), DailyPay (US), Branch,
Tapcheck, Wagestream, EarnIn, and OrbisPay using a common earned-
wage ledger format
Normalize pay-cycle rules (monthly vs. biweekly) across providers
so eligibility figures are comparable across employer populations
Expose a unified advance-request and repayment API surface to
downstream analytics and lending decisioning systems
Maintain per-employer cycle models so the eligibility figure
matches what each worker sees at any point in the month
============================
BENEFITS & ADVANTAGES
--------------------
Live eligibility, not a stale balance
The available-to-advance amount recomputes continuously as the pay
period elapses — not just at payroll close — so downstream systems
always show what the worker actually sees in the app.
Full lifecycle coverage in one integration
From eligibility lookup through advance creation, disbursement
confirmation, and repayment deduction — the entire advance ledger
is captured without requiring separate connections to employer
payroll systems.
Colombian regulatory compliance built in
Consent and access logs are retained, data is scoped to fields the
project needs, and the integration is designed against Ley 1581 de
2012 (Habeas Data) and Decreto 1297 de 2022 from day one.
Pay-cycle skew handled automatically
Monthly and biweekly employer cycles are modeled so eligibility
figures are accurate regardless of where the worker sits in their
pay period, across different employer configurations.
Disbursement-to-settlement gap properly managed
In-flight advances (disbursed but not yet deducted) are tracked
separately from settled repayments, preventing double-counting
and ensuring missed payroll cycles are visible rather than dropped.
Ancillary spend categorized apart from advances
Top-ups, bill payments, subscriptions, and transit reloads are
exposed as a separate spend stream, so integrators can build
benefit-budget reporting without conflating spend types.
Maintenance coverage against front-end drift
A re-check step monitors the worker portal between releases,
surfacing changed endpoints or fields before downstream reports
are affected — delivered with the integration package.
============================
SUBSCRIPTION PLANS
--------------------
Two engagement models are available for the Advance - Adelanta Tu
Pago integration:
------------
SOURCE CODE DELIVERY
------------
Full runnable source in Python and Node.js
OpenAPI/Swagger spec for all covered endpoints
Normalized earned-wage ledger schema
Automated tests for advance lifecycle and repayment reconciliation
Protocol and auth-flow report with error-condition mapping
Consent and data-retention guidance under Colombia's Habeas Data regime
Starting from $300 USD
Billed only after delivery, once the buyer is satisfied
Delivered on a one-to-two-week cycle
------------
HOSTED PAY-PER-CALL API
------------
Call OpenBanking Studio endpoints directly — no source code required
No upfront cost; usage billed per API call
Same data coverage as the source-code package
Suitable for lower-volume integrations or proof-of-concept phases
Onboarding includes consented access setup with the buyer
------------
Both options include consented access arrangement during onboarding —
either a consenting employee account or an employer test account —
so field mapping is proven against real responses before the
integration goes live.
============================
CONCLUSION
--------------------
The Advance - Adelanta Tu Pago salary advance API integration delivers
access to one of Colombia's most widely deployed earned-wage access
platforms, covering 200,000-plus employees across employer-sponsored
workforces. The data — live eligibility, request lifecycle, disbursement
events, repayment deductions, and ancillary spend — is available through
a single consented interface integration that handles pay-cycle complexity,
regulatory compliance, and disbursement-to-settlement accounting out of
the box.
Whether building an HR dashboard, a financial-wellness tool, a payroll
reconciliation pipeline, or a multi-source earned-wage aggregator for
the Latin American market, the Adelanta Tu Pago integration provides
the ledger data that makes each of those use cases viable without
rebuilding the underlying advance engine.
For teams targeting Colombia's open-finance ecosystem or assembling
a unified EWA layer alongside Minu, Symplifica, Runa, DailyPay, or
Wagestream, this integration slots in via a normalized schema designed
to make cross-provider comparison reliable.
To start, send the app name and required data fields through the
contact page — consented access is arranged during onboarding, and
delivery follows a one-to-two-week cycle.
--------------------
Access the full integration specification and get started at:
https://openfinance-lab.com/advance-adelanta-tu-pago.html
============================
OpenBanking Studio — authorized interface integration and API delivery.
Advance - Adelanta Tu Pago and Advance your pay Colombia S.A.S. are
independent of this studio. This article maps integration options and
implies no affiliation or endorsement.
============================