Finance & Insurance
Project engagementTurning complex payment APIs into a clearer integration experience for developers.
Garanti BBVA E-Ticaret Developer Portal
Industry
Payments & Developer Platforms
Sector
Finance & Insurance
Engagement
Project engagement
Client context
01GÖSAŞ is the client organisation. Garanti BBVA E-Ticaret Developer Portal is the public platform name for the developer-facing payment integration experience at dev.garantibbva.com.tr.
Business challenge
02The regulated payment ecosystem brings together products such as Virtual POS, Switch, Card Storage, Security Platform and GarantiPay 2.0, alongside sales, cancellation, refund, query, pre-authorisation, token and mobile integration documentation that serves different technical needs.
User problem
03Developers need to find the right product and API, move between transaction types, understand security and signature requirements, and reach testing, error-resolution and support content quickly.
MadeByCat role
04Developer experience strategy, information architecture, UX/UI design, responsive interface design, frontend/platform implementation, reusable interface patterns, technical-content presentation and launch collaboration. Backend payment, banking and API ownership is not claimed in this record.
Transformation
05API, product and support content across the Garanti BBVA E-Commerce ecosystem was brought together as a discoverable, task-led and maintainable developer portal experience.
We structured the work around content and task inventory, developer journeys, a product-to-transaction-to-API hierarchy, search and filtering, reusable documentation patterns, and a responsive bilingual experience.
Solution
06A live developer portal experience that combines product discovery, technical documentation, error-resolution material and support paths in one consistent platform for payment integrations.
Evidence & outcomes
The live portal presents an API catalogue and search with product areas including Virtual POS, Switch, Card Storage, Security Platform and GarantiPay.
Qualitative · Garanti BBVA E-Ticaret Developer Portal (official)
Observable documentation covers sales, cancellation, refund, query, pre-authorisation, token operations, JWS/JWK, mobile integration, test cards, error codes, FAQ, support and Turkish/English access.
Qualitative · Garanti BBVA E-Ticaret Developer Portal (official)
MadeByCat role is limited to the developer experience and platform presentation layer, not core payment or API ownership.
Qualitative · MadeByCat project record
Services & capabilities
Capabilities: Developer Experience · UX Research & IA · Interface Design · Technical Content Presentation
Questions
- Who was the client for this case study?
- The client is GÖSAŞ (Garanti Ödeme ve Elektronik Para Hizmetleri A.Ş.). Garanti BBVA E-Ticaret Developer Portal is the public project and platform name.
- What did MadeByCat deliver?
- Developer experience strategy, information architecture, UX/UI, responsive interface design, frontend/platform implementation, reusable interface patterns, technical-content presentation and launch collaboration.
- Does this case claim MadeByCat built the underlying payment APIs?
- No. The case describes the developer portal and technical-content experience layer, not ownership of core payment processing, banking infrastructure or API backends.
Evidence & sources
- Garanti BBVA E-Ticaret Developer Portal (official)Client official