TKPAY

MVP Delivery Timeline 21 wk

End-to-End Fintech Modules 12

Jira Tasks Delivered 800+

Overview

TKPAY is THY Financial Technologies' entry into licensed electronic money and payment services, built as two connected products: an open-loop digital wallet and a Payment Facilitator (PF) infrastructure. Valensas was selected as the technology partner responsible for end-to-end delivery — from business analysis and technical design through TCMB compliance, UAT, code handover and extended maintenance.

Discover more

The Challenge

TKPAY needed a full licensed-fintech stack — wallet, KYC, payments, accounting — inside a 21-week window and under the strict security perimeter of a flag carrier airline. Compliance, access constraints and a late-arriving prepaid card provider combined to make schedule protection the hardest engineering problem of the project.

A 21-week MVP window for what would normally be a multi-year fintech build-out.
A 2-week late start without the end date moving — effectively compressing the plan to 19 weeks.
Regulatory framing from TCMB plus an external compliance consultant to coordinate with.
Strict security controls: VPN approvals, late Keycloak permissions, restricted access between Valensas and TKPAY test environments.
A prepaid card provider selected late in the project, blocking integration documentation.
Late-stage scope expansion: Open Banking (YÖS) added mid-flight and delivered on plan.

Our Approach

We treated TKPAY as a set of numbered, independently deliverable modules. Every module began with a business analysis and technical design document approved by TKPAY before development started — a disciplined "analyze, design, build, transfer" loop that made the tight timeline predictable rather than heroic.

Modular delivery

12 numbered modules (KYC, FAST, CRM, BKM QR, AML, Exchange, Campaign, Prepaid, SMS OTP, Wallet Mobile App, Accounting/SAP, Open Banking) each with its own technical design doc, OpenAPI / AsyncAPI spec and Jira backlog.

Compliance-first KYC

NFC ID reading, MRZ scanning, liveness check and a Valensas-built face-recognition service (DeepFace with VGG-Face / Facenet / SFace) combined with e-Devlet services (MERNİS, KPS, NVİ) and Vault-backed secure storage.

Event-driven core

Spring Boot + Kotlin microservices communicating over Apache Kafka with OpenAPI and AsyncAPI contracts kept the wallet, payments and accounting paths loosely coupled and independently testable.

External integrations

SAP accounting integration via a Kafka-driven accounting service, BKM Karekod for QR payments, Open Banking through YÖS, and Figensoft for SMS OTP.

Structured handover

A 2-day business analysis workshop, per-module demos and a fully written + verbal transfer completed the project on 28–30 May 2024.

Technology Stack

Core technologies selected to deliver a secure, resilient, regulation-ready system.

Kotlin Spring Boot Python 3.12 (Flask) PostgreSQL Apache Kafka Keycloak HashiCorp Vault (KV v2) MinIO DeepFace (VGG-Face / Facenet / SFace) NFC / MRZ / Liveness OpenAPI AsyncAPI SAP integration BKM Karekod Open Banking (YÖS) Figensoft (SMS OTP) Kubernetes

Mobile: iOS and Android native wallet with KYC. REST + Kafka contracts documented in OpenAPI and AsyncAPI.

Key Results

TKPAY reached UAT approval without disrupting the internal target and was handed over on plan, with the bulk of 800+ Jira tasks closed and 12 of 12 defined modules fully delivered.

MVP delivered in a 19-week window, mid-project Open Banking scope expansion added two weeks to completion.
12 fintech modules delivered end-to-end, each with its own technical design doc and API contracts.
Full KYC ecosystem: NFC, MRZ, liveness, e-Devlet (MERNİS/KPS/NVİ) and Valensas-built face recognition.
Open Banking (YÖS) integration enabling account-to-wallet transfers from linked bank accounts.
SAP accounting integration that records financial transactions automatically.

Team Ownership

The complete TKPAY technology stack is owned by THY Financial Technologies today. Per-module documentation, API contracts and deployment blueprints were designed from day one to make the system independently maintainable by the client's teams.

Transferred to the client

Full source code for all 12 modules, with per-module technical design docs, OpenAPI specs and AsyncAPI specs on Confluence (TAC space).
iOS and Android native wallet applications, delivered with KYC flows.
Deployment-ready Kubernetes configuration; technical deployment performed by the TKPAY team with Valensas guidance.
A documented handover — 2-day business analysis workshop, per-module demos, and a written + verbal transfer completed 28–30 May 2024.
A recommendation package for the out-of-scope AML and rule-based fraud-detection modules.
Post-delivery engagement through 2025, including a 3-month on-site support window (May–July 2025).