Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Sanal POS API’sini hızlı denemek için iki koleksiyon sunuyoruz:

Postman Collection

Postman 10+ ile uyumlu v2.1 koleksiyon. Tüm endpoint’ler, örnek payload’lar ve environment dahil.

.http Dosyası

VS Code REST Client, JetBrains IDE’leri ve Visual Studio için.

​
Postman ile başlama

1

Koleksiyonu indirin

Yukarıdaki “Postman Collection” linkinden .json dosyasını indirin.
2

Postman'e import edin

Postman → Import → dosyayı sürükle-bırak.
3

Environment'ı seçin

Sağ üstteki dropdown’dan Payven Sandbox veya Payven Production environment’ını seçin.
4

Değişkenleri doldurun

Environment değişkenlerine API anahtar bilgilerinizi yazın:
  • apiKey: pvk-test-...
  • apiSecret: secret değeriniz
  • merchantId: merchant ID’niz
  • baseUrl: sandbox veya production URL
5

Bir isteği gönderin

“Quickstart” klasöründeki Non-3D Payment isteğini açın ve Send edin.

​
Koleksiyon içeriği

Klasörİçerik
Quickstartİlk Non-3D ödeme, durum sorgusu
PaymentsTüm ödeme akışları
Refundsİade istekleri
WebhooksAbonelik yönetimi + test çağrısı
InquiriesListe, detay, geçmiş
ReconciliationMutabakat akışı
BackofficeKonnektör, konfigürasyon (Bearer auth gerektirir)

​
.http dosyası ile başlama

VS Code’da REST Client eklentisi yüklüyse: 
# Dosyayı açın
code payven-sanalpos.http

# Üst kısımdaki @apiKey, @apiSecret, @merchantId değişkenlerini doldurun
# İstek bloğunun üstündeki "Send Request" linkine tıklayın

​
Otomasyon ile değişken aktarma

Postman içinde “Pre-request Script” ve “Tests” bölümleri kullanılarak istekler arası değer paylaşımı yapılır: 
// Tests bölümünden — paymentId'yi sonraki isteğe taşımak
const response = pm.response.json();
if (response.data?.id) {
  pm.environment.set("lastPaymentId", response.data.id);
}
Sonraki istekte {{lastPaymentId}} ile kullanın.