Skip to main content
Payven, geleneksel “her dil için resmi SDK” yaklaşımı yerine AI-native + OpenAPI-native bir geliştirici deneyimini hedefler. Bu sayfa mevcut araçları ve yakında çıkacakları listeler.

​
AI-native: MCP Server (Faz 1)

Model Context Protocol (MCP), AI ajanlarının harici servislere standart bir şekilde bağlanmasını sağlar. @payven/mcp server’ı sayesinde Cursor, Claude, Windsurf veya Continue gibi araçlarda doğrudan Payven API’sini kullanabilirsiniz. 
# Geliyor
npm install -g @payven/mcp

// .cursor/mcp.json (örnek)
{
  "mcpServers": {
    "payven": {
      "command": "npx",
      "args": ["-y", "@payven/mcp"],
      "env": {
        "PAYVEN_CLIENT_ID":     "pvk_test_...",
        "PAYVEN_CLIENT_SECRET": "..."
      }
    }
  }
}
Sonra editör içinde: “Payven’de son 24 saatte başarısız olan ödemeleri listele ve neden başarısız olduklarını açıkla” yazıp doğrudan çalıştırabilirsiniz.
Türkiye’nin ilk AI-native fintech altyapısı. MCP server beta erişimi için destek ekibimize yazın.

​
TypeScript SDK (Faz 2)

# Geliyor
npm install @payven/node

import { PayvenClient } from "@payven/node";

const payven = new PayvenClient({
  slug:         "payven",
  clientId:     process.env.PAYVEN_CLIENT_ID!,
  clientSecret: process.env.PAYVEN_CLIENT_SECRET!,
});

// Auto token refresh + retry + idempotency dahili
const payment = await payven.sanalpos.payments.create({
  externalId:    "ORDER-1001",
  amount:        { amount: 15000, currency: "TRY" },
  installment:   1,
  operationType: "sale",
  card:          { /* ... */ },
}, { idempotencyKey: "order-1001-payment" });

console.log(payment.transactionId, payment.status);
Içerikler:
  • Auto token refresh + cache
  • Idempotency-Key otomatik üretim opsiyonu
  • Retry + exponential backoff + jitter
  • Tip güvenliği (OpenAPI’den auto-generated)
  • Cancellation token desteği

​
Diğer diller — OpenAPI codegen

Resmi SDK olmadığı diller için openapi-generator ile otomatik istemci üretebilirsiniz. OpenAPI specs’lerimizde servers ve securitySchemes tanımlı — generator default şablonlarla çalışır. 
# Python
openapi-generator-cli generate \
  -i https://docs.payven.com.tr/api-reference/sanal-pos/openapi.json \
  -g python \
  -o ./payven-python

# C# (.NET)
openapi-generator-cli generate \
  -i https://docs.payven.com.tr/api-reference/sanal-pos/openapi.json \
  -g csharp-netcore \
  -o ./payven-dotnet

# Go
openapi-generator-cli generate \
  -i https://docs.payven.com.tr/api-reference/sanal-pos/openapi.json \
  -g go \
  -o ./payven-go

# PHP
openapi-generator-cli generate \
  -i https://docs.payven.com.tr/api-reference/sanal-pos/openapi.json \
  -g php \
  -o ./payven-php

# Java
openapi-generator-cli generate \
  -i https://docs.payven.com.tr/api-reference/sanal-pos/openapi.json \
  -g java \
  -o ./payven-java
Üretilen istemcide Authorization: Bearer ... header’ını manuel set etmeniz veya bir interceptor yazmanız gerekir. Token alma (Identity /auth/{slug}/token) için kanonik Kimlik Doğrulama kod örnekleri kopyalanabilir.

​
Postman Collection

Postman koleksiyonumuz, ortam değişkenleri ve auto-token-refresh script’i ile birlikte hazırlanıyor. 
Geliyor: https://docs.payven.com.tr/postman/payven.postman_collection.json
İçerikler:
  • 2 environment: Sandbox, Production
  • Ortam değişkenleri: client_id, client_secret, slug, merchant_id
  • Pre-request script: token cache + auto-refresh
  • Tüm endpoint’ler için örnek request

​
Mevcut araçlar

Deneme paneli

API Referansı tab’ında her endpoint için tarayıcıdan canlı deneme.

Konsol

İşlem izleme, raporlama, anahtar yönetimi.

Test Kartları

Sandbox senaryoları için hazır kart numaraları.

Webhook Teslim Logları

Konsoldan her teslim denemesinin tam request/response geçmişi.

​
Geri bildirim

SDK / MCP server / Postman collection için öncelik sırası ve dil tercihi geri bildirimi: destek ekibine ulaşın. Beta erişim için kayıt almıyoruz; tüm araçlar hazır olduklarında public olarak yayınlanacak.