İçeriğe geç
Better Payment
Başlarken

Giriş

Node.js ve Türk ödeme sağlayıcıları için tip güvenli, birleşik ödeme kütüphanesi.

Better Payment, Türk ödeme sağlayıcılarını (iyzico, PayTR, Akbank, Parampos, Sipay, Kuveyt Türk, Garanti BBVA, Yapı Kredi, QNB, VakıfBank, Albaraka Türk, Denizbank ve EST bankaları: İş Bankası, Ziraat, Halkbank, TEB, Şekerbank) tek bir TypeScript API'siyle entegre etmenizi sağlar.

Neden Better Payment?

Her ödeme sağlayıcısının kendi SDK'sı, istek formatı, imza yöntemi ve hata modeli var. Better Payment bu farkları tek bir arayüzün arkasına gizler.

Tek API

createPayment, initThreeDSPayment, refund, cancel ve getPayment her sağlayıcıda aynı şekilde çalışır.

Doğrulanmış callback'ler

3D Secure callback'leri, hiçbir sonuca güvenilmeden önce sizin kimlik bilgilerinizle kontrol edilir.

Güvenli HTTP handler

Framework'ten bağımsız handler yalnızca sizin açtığınız işlemleri sunar; authorize ve tutarı sunucuda belirleme hook'ları vardır.

Çoklu sağlayıcı

Birden fazla sağlayıcıyı aynı anda etkinleştirin, her istekte birini seçin.

Plugin'ler

Ödeme olayları, sağlayıcı yönlendirme ve daha fazlası plugin olarak gelir. Kendi plugin'inizi birkaç satırda yazın.

Desteklenen sağlayıcılar

Sağlayıcı3D'siz3D SecureİadeİptalDurumBINTaksit
iyzico
PayTR ¹ iFrame / Direct API ²
Akbank 3D_PAY——
Parampos (TRY)
Sipay ⁴ paySmart3D ⁴
QNBpay ⁵ paySmart3D
Kuveyt Türk— KT Pay Gate ³——
EST (İş Bankası, Ziraat, Halkbank, TEB, Şekerbank) 3D / 3D Pay / 3D Host——
Denizbank 3D Model———
Albaraka Türk 3D——
VakıfBank MPI + VPOS (3DS)———
Yapı Kredi Posnet OOS———
QNB 3D Model / 3D Pay——
Garanti BBVA 3D / 3D_PAY / GarantiPay——

¹ PayTR hesabınızın 3D'siz ödemeler için onaylanmış olması gerekir. ² PayTR'de iptal (void) uç noktası yoktur; bu yüzden cancel() tam iade yapar. ³ Kuveyt Türk'te iptal aynı gün, gün sonundan önce yapılır; sonrasında refund() kullanın. ⁴ Sipay'de iptal (void) uç noktası yoktur: cancel() ödemenin kalanını iade eder, Sipay bunu aynı gün içinde iptal olarak işler. 3D'siz ödeme için hesabınızın Sipay tarafından onaylanması da gerekir. ⁵ QNBpay, Sipay'in altyapısında çalışır (qnbpay()); bu yüzden Sipay notları geçerlidir. Henüz bir test üye işyeriyle doğrulanmadı.

Kısa örnek

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

const payment = betterPayment({
  mode: 'sandbox',
  providers: {
    iyzico: iyzico({
      apiKey: process.env.IYZICO_API_KEY!,
      secretKey: process.env.IYZICO_SECRET_KEY!,
    }),
  },
});

const result = await payment.initThreeDSPayment({
  price: '100.00',
  paidPrice: '100.00',
  currency: 'TRY',
  basketId: 'B1',
  callbackUrl: 'https://yoursite.com/api/pay/iyzico/payment/complete-3ds',
  paymentCard: { /* ... */ },
  buyer: { /* ... */ },
  shippingAddress: { /* ... */ },
  billingAddress: { /* ... */ },
  basketItems: [{ /* ... */ }],
});
// Render result.threeDSHtmlContent in the customer's browser

Sonraki adımlar

3.x'ten mi geçiyorsunuz? Geçiş rehberini izleyin.