Advance - Adelanta Tu Pago: API integration & OpenFinance services

Deliverables checklist

• OpenAPI 3.1 specification covering login, advance, ledger and webhook endpoints
• Protocol and authorization flow report (token lifecycle, device binding, refresh chain)
• Runnable reference clients in Python and Node.js, plus Postman collection
• Automated regression tests against a sandbox employer profile
• Compliance brief mapped to Decreto 1297 of 2022 and Habeas Data (Ley 1581 of 2012)
• Operational runbook: rate limits, error taxonomy, retry policy, idempotency keys

Engagement models

We offer two ways to consume the Adelanta Tu Pago integration so finance and engineering teams can pick whatever fits their procurement reality.

• Source code delivery from $300 — we hand over a runnable backend, OpenAPI docs and tests. You host it yourself; you only pay after acceptance.
• Pay-per-call hosted API — we run the integration as a managed endpoint and you pay per successful API call, with no upfront commitment. Useful when an HR-tech or fintech team wants to test demand before building in-house.

1. HRIS payroll reconciliation

An employer using ADP, SAP SuccessFactors or a local Colombian payroll engine wants every Adelanta Tu Pago advance to flow back as a pre-payday deduction. We pull the advance.disbursed events through a webhook, normalize them to the employer's chart of accounts, and post them as payroll input lines so net pay is correct on the 30th. This closes the OpenFinance loop between an EWA provider and the back office.

2. Financial wellness dashboard

A people-analytics team builds a cohort dashboard answering: which teams trigger the most advances, what is the average gap-to-payday, and what is the impact on retention. We expose anonymized advance ledger and accrual data via a read-only API; the dashboard joins it with absenteeism and turnover figures from the HRIS, enabling the kind of financial-wellness reporting that fintechs like Minu and Wagestream popularized in Latin America.

3. Treasury liquidity forecast

Finance needs to know the daily cash advance volume to size their working-capital line. We stream advance.requested and advance.disbursed into a TimescaleDB instance, the integration job runs every 15 minutes, and a forecasting model projects out-flows for the next two pay cycles. The same data feeds counterparty reporting if a credit line is partially drawn from a Colombian bank.

4. OpenFinance consent-based portability

An employee wants to share their Adelanta Tu Pago advance history with a third-party budgeting app or a credit bureau alternative. Under the Colombian Open Finance model the employee grants explicit consent; our integration validates the consent token, returns only the agreed fields, logs the access for audit, and revokes on demand. This is the pattern Konsentus and Latinia describe as the operational core of Colombia's Open Finance rollout.

5. Telco partner settlement

The in-app airtime and mobile data top-ups generate a B2B settlement file owed to carriers. We expose a topup.purchased stream filtered by carrier, generate a daily CSV with carrier, MSISDN, package code and gross amount in Colombian Pesos, and push it to the partner SFTP, replacing the manual reconciliation step that often blocks growth in this kind of EWA-plus-benefits model.

Account login & session refresh

// Mirror the in-app authorization flow and bind a server session
POST /api/v1/adelanta/auth/login
Content-Type: application/json

{
  "employee_id": "CO-1098765432",
  "employer_code": "EMP_ACME_CO",
  "device_fingerprint": "fp_4f1c...",
  "otp": "493812"
}

200 OK
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "rtk_8d2a...",
  "expires_in": 1800,
  "scope": ["advance.read","ledger.read","topup.read"]
}

Advance ledger query

// Pull a paged list of past advances for a given period
GET /api/v1/adelanta/advances?from=2026-04-01&to=2026-04-30&page=1
Authorization: Bearer <ACCESS_TOKEN>
X-Idempotency-Key: q-2026-04-page-1

200 OK
{
  "items": [
    {
      "advance_id": "ADV_01H...",
      "requested_at": "2026-04-12T14:08:21-05:00",
      "amount_cop": 350000,
      "status": "DISBURSED",
      "fee_cop": 0,
      "deduction_cycle": "2026-04-30",
      "channel": "MOBILE_APP"
    }
  ],
  "next_page": null
}

Webhook: advance status events

// Receive real-time status changes (HMAC SHA-256 signed)
POST https://your-app.example.com/hooks/adelanta
X-Adelanta-Signature: t=1715299200,v1=4f1c...

{
  "event": "advance.disbursed",
  "advance_id": "ADV_01H...",
  "employee_id": "CO-1098765432",
  "amount_cop": 350000,
  "disbursed_at": "2026-04-12T14:09:55-05:00",
  "bank": {"code": "BANCOLOMBIA", "account_mask": "****8821"}
}

// Standard responses: 2xx ack, 4xx replay, 5xx auto-retry up to 24h

Compliance & privacy

Colombia's earned wage access market sits inside the Open Finance framework introduced by Decreto 1297 of 2022, which makes data sharing voluntary but tightly consent-driven, and inside the Habeas Data regime defined by Ley 1581 of 2012. Every integration we deliver carries an explicit consent flow, captures the legal basis for each data scope, and ships an audit log so a Superintendencia Financiera review can be answered with evidence rather than promises.

Where international employers consume the same APIs, we extend the model with GDPR-style minimization and EU-side processor agreements; this matters in 2025 deals where a Spanish or US parent company asks for the same advance ledger data the Colombian HR team already sees.

Data flow / architecture

The reference pipeline keeps the surface area small and traceable:

• Adelanta Tu Pago app / backend — source of truth for advances, deductions, top-ups.
• OpenFinance Lab integration gateway — handles auth, rate limiting, signing and consent enforcement.
• Storage layer — Postgres for state, S3-compatible object store for raw event archives.
• Consumption layer — REST APIs, webhooks, daily CSV / Parquet exports to BI or the employer payroll engine.

Market positioning & user profile

Advance - Adelanta Tu Pago is a B2B2E product: the contracting customer is the employer (typically a mid-to-large Colombian company) while the daily user is the employee, mostly Android users on prepaid or hybrid mobile plans. The provider, Advance your pay Colombia S.A.S., is registered in Bogotá and positions itself as the first financial wellness platform in Colombia. This puts the page's audience squarely inside the Latin American on-demand pay segment that, according to Fortune Business Insights, is part of a global EWA market projected to grow from USD 8.84 billion in 2026 to roughly USD 52 billion by 2034.

One concrete signal from the last two years: in December 2024 CloudPay partnered with Banco Santander to deliver real-time earned wage access in Spain, and in July 2025 Rain shipped an embedded EWA module inside Workday. Both announcements pushed enterprise HRIS vendors and Latin American payroll teams to re-evaluate how their existing EWA partners (including Adelanta Tu Pago) expose data to the broader stack — which is exactly the integration gap this page addresses.

About OpenFinance Lab

We are an independent technical studio focused on App protocol analysis and authorized API integration for fintech, banking and consumer apps. The team has shipped EWA, OpenBanking and OpenFinance integrations across Latin America, Europe and South-East Asia, and works comfortably with both the consumer-app side (Android / iOS protocol work) and the enterprise back office (HRIS, payroll engines, ERPs).

• Source code delivery from $300 — runnable API source plus docs, paid after acceptance.
• Pay-per-call hosted API — usage-based pricing, no upfront fee, ideal for early validation.
• One-stop scope: protocol analysis → OpenAPI design → build → tests → compliance brief.
• Cross-border ready: bilingual delivery (English / Spanish) and timezone overlap with US, EU and LatAm.

DailyPay

US-based EWA pioneer that lets employees access up to 100% of accrued wages, capped daily. Holds a deep ledger of micro-disbursements that, when joined with Adelanta Tu Pago records, gives multinational employers a unified on-demand pay view.

Payactiv

Founded in 2012 in Milpitas, California; serves restaurants, factories, hospitals and retail. Its API exposes wage access events that pair naturally with Latin American EWA feeds for cross-border financial wellness reporting.

ZayZoon

Mid-market focused, charges employees a flat fee per pay period for wage access. Useful reference when designing fee-tier modeling on top of an Adelanta Tu Pago zero-interest baseline.

Branch

Employer-backed, free for companies; the data shape (advances + spending card transactions) is similar enough that a unified extractor can serve both.

Wagestream

UK-origin EWA platform with strong financial-wellness telemetry. Teams already integrating Wagestream often want the same advance and accrual fields out of Adelanta Tu Pago for parity.

EarnIn

US consumer-facing wage advance app with a tipping model. Frequently appears alongside Adelanta Tu Pago in cross-region payroll-tech evaluations.

Minu

Mexico City-based pay-on-demand leader, 1M+ users and 300+ enterprise customers including Grupo Modelo, Coppel and Cinemex. The closest LatAm peer to Adelanta Tu Pago in product shape.

Symplifica

Colombian fintech that formalizes domestic-employee payroll. Different segment, but shares the Colombian payroll-deduction integration surface, which makes the underlying Open Finance plumbing reusable.

Rain

EWA provider that, in July 2025, launched embedded on-demand pay inside Workday. Sets the bar for native HRIS integration that Latin American EWA stacks are now expected to match.

OrbisPay & PayCaptain

Daily-wage withdrawal and salary-advance platforms commonly bundled into HR-tech RFPs. Their existence in the same comparison set means clients evaluating Adelanta Tu Pago often want a side-by-side ledger view.

Engagement workflow

1. Scope confirmation: which Adelanta Tu Pago objects you need (advances, ledger, top-ups, deductions) and which downstream system consumes them.
2. Protocol and authorization analysis (2–5 business days).
3. OpenAPI design + build of reference clients (3–8 business days).
4. Tests, sandbox employer profile and compliance brief (1–2 business days).
5. Acceptance & handover; pay only after the integration passes your test plan.

FAQ

What do you need from me to scope an Adelanta Tu Pago integration?

How long does the first delivery take?

How do you handle compliance with Colombia Open Finance rules?

Do you support both Android and iOS protocol analysis for Adelanta Tu Pago?