← Back to work

Telcel · Claro Pay · 2024 — 2025

Designed Telcel's payment orchestration platform end to end: one gateway for every sales channel, many payment engines behind it, with retries, anti-fraud scoring and PCI DSS-compliant tokenization.

Client
Telcel · Claro Pay
Role
Solution architect · PCI DSS
Year
2024 — 2025

Outcomes

8+payment engines behind one API
PCI DSStokenized, vault-isolated card data
34servers in the production design
N → 1integrations per channel

Context

Telcel collects payments through many channels — the self-service portal, Telcel.com, the Claro Pay wallet and partner channels — and each one used to integrate payment providers on its own. I designed the Gestor de Pagos: a single orchestration layer every channel calls, which routes each transaction to the right payment engine, scores it for fraud, keeps card data inside a tokenized vault and retries what fails — while keeping the PCI DSS scope as small as possible.

What I built

  1. 01

    The architecture: an orchestrator/gateway with asynchronous workers in front of 8+ payment engines (banks, card acquirers, cash networks, wallets), exposed to channels through payments, payment-methods, card-management and auth microservices.

  2. 02

    Every kind of payment method behind one contract: cards, bank debits, cash references and wallets — adding a new engine doesn't touch the channels.

  3. 03

    Reliability: retry policies for failed transactions, Kafka-driven payment notifications and scheduled jobs, on a four-node gateway and application cluster behind Nginx.

  4. 04

    Risk: a customer payment profile that feeds scoring, a transaction profiler and an external anti-fraud engine before a charge is authorized.

  5. 05

    PCI DSS by design: card data is tokenized and isolated in a dedicated vault (HashiCorp Vault plus a segregated vault database), so channels never handle it; configuration and secrets live in Consul and Vault.

  6. 06

    Operations: back-offices for transactions and business rules, dashboards, alerts and reports, ELK observability and Jenkins CI/CD — sized as a 34-server production design.

Architecture

ChannelsExposed APIsPayment enginesData & platformWallet appSelf-service portalWebPartner channelsPayments APIPayment methodsCard managementAuthRisk enginescoring · profiling · anti-fraudOrchestratorgateway · workers · retriesToken vaultHashiCorp Vault · PCI DSS scopeBanksCard acquirersCash networksWallets+ N enginesMongoDBRedisKafka · notificationsBack-office · rulesELK observability
Simplified architecture — processor, bank and host names omitted.
Next projectGenerative Accelerator