Test Kartları ve Sandbox Kurulumu

better-payment ile gerçek para transferi yapmadan ödemeleri test etmek iki şekilde mümkündür:

1. Bellek İçi Mock Sağlayıcı (better-payment/testing): Birim testleri, CI boru hatları ve yerel geliştirme için en uygundur. Harici ağ istekleri veya kimlik bilgileri gerektirmeden tamamen bellekte çalışır. Sihirli kart numaralarının tam listesi ve test denetimleri (failNext, networkErrorNext) için Test sayfasına bakın.
2. Sağlayıcı Sandbox Ortamı (mode: 'sandbox'): Canlı ortama geçmeden önce gerçek sağlayıcı test ortamlarına karşı uçtan uca doğrulama için en uygundur.

Bellek İçi Mock Sağlayıcı

Uygulama testleri için better-payment/testing paketi MockProvider sağlar. API kimlik bilgileri gerektirmez ve sihirli kart numaralarıyla kesin sonuçlar sunar.

Kurulum talimatları, istek örnekleri ve MOCK_CARDS (SUCCESS, INSUFFICIENT_FUNDS, CARD_DECLINED, THREEDS_REQUIRED vb.) referans tablosunun tamamı için Test sayfasına bakın.

Sağlayıcı Sandbox Kurulumu

betterPayment başlatılırken mode: 'sandbox' olarak ayarlayın. Sandbox modunda her sağlayıcı otomatik olarak kendi sandbox uç noktasına bağlanır:

import { betterPayment, iyzico, paytr, akbank, parampos } from 'better-payment';

const payment = betterPayment({
  mode: 'sandbox',
  providers: {
    iyzico: iyzico({
      apiKey: process.env.IYZICO_SANDBOX_API_KEY!,
      secretKey: process.env.IYZICO_SANDBOX_SECRET_KEY!,
    }),
    paytr: paytr({
      merchantId: process.env.PAYTR_SANDBOX_MERCHANT_ID!,
      merchantKey: process.env.PAYTR_SANDBOX_MERCHANT_KEY!,
      merchantSalt: process.env.PAYTR_SANDBOX_MERCHANT_SALT!,
    }),
    akbank: akbank({
      merchantSafeId: process.env.AKBANK_SANDBOX_MERCHANT_SAFE_ID!,
      terminalSafeId: process.env.AKBANK_SANDBOX_TERMINAL_SAFE_ID!,
      secretKey: process.env.AKBANK_SANDBOX_SECRET_KEY!,
    }),
    parampos: parampos({
      clientCode: process.env.PARAMPOS_SANDBOX_CLIENT_CODE!,
      clientUsername: process.env.PARAMPOS_SANDBOX_CLIENT_USERNAME!,
      clientPassword: process.env.PARAMPOS_SANDBOX_CLIENT_PASSWORD!,
      guid: process.env.PARAMPOS_SANDBOX_GUID!,
    }),
  },
});

Ortam değişkenlerini ayarlama ayrıntıları için Kurulum sayfasına bakın.

iyzico Sandbox

• Sandbox Uç Noktası: https://sandbox-api.iyzipay.com
• Dokümantasyon: iyzico Test Kartları

Test Kartları

Bu iki kart, her gece çalışan sandbox testlerimizin kullandığı kartlardır. 3D Secure adımı (sandbox'ın istediği doğrulama kodu) ve senaryo kartlarının tam listesi için resmi iyzico Test Kartları sayfasına bakın.

PayTR Sandbox

• Sandbox Uç Noktası: https://www.paytr.com (PayTR tek bir uç nokta kullanır; sandbox modunda otomatik olarak test_mode: 1 gönderilir)
• Dokümantasyon: PayTR Geliştirici Portalı

Test Kartları

mode: 'sandbox' ile better-payment her isteğe test_mode=1 ekler. Değiştirmek için sağlayıcı ayarında testMode verin. Diğer test kartları ve 3D Secure test adımı için PayTR geliştirici dokümantasyonuna bakın.

Akbank Sandbox

• Sandbox Uç Noktası: https://apipre.akbank.com/api/v1/payment/virtualpos
• Dokümantasyon: Akbank API Portalı

Akbank, test kartlarını ve kimlik bilgilerini test üye işyeri hesabınızla birlikte sağlar; Akbank temsilcinizle iletişime geçin.

Parampos Sandbox

• Sandbox Uç Noktası: https://test-dmz.param.com.tr/turkpos.ws/service_turkpos_test.asmx
• Dokümantasyon: Param Geliştirici Dokümantasyonu

Parampos, test kartlarını, test kimlik bilgilerini (Müşteri Kodu, Kullanıcı Adı, Şifre ve GUID) ve SOAP uç noktalarını test üye işyeri hesabınızla birlikte sağlar; Param temsilcinizle iletişime geçin.