Better Payment
Başlarken

Kurulum

Better Payment'i kurun ve ortamınızı hazırlayın.

Gereksinimler

  • Node.js >= 20.0.0 ya da bir edge ortamı: Vercel Edge, Cloudflare Workers, Deno veya Bun
  • TypeScript >= 5.0 (önerilir)

better-payment'in hiç runtime bağımlılığı yoktur. Yalnızca fetch ve WebCrypto kullandığı için aynı paket Node.js'te ve edge ortamlarında çalışır. better-payment/client tarayıcıda güvenle kullanılabilir.

Kurulum

npm install better-payment

Beta sürüm

Yeni provider'lar, plugin'ler ve özellikler önce beta olarak (örneğin 0.12.0-beta.1) npm beta etiketinde yayınlanır. Beta rozetli sayfalar bunları anlatır. Denemek için beta sürümü kurun:

npm install better-payment@beta

Beta, stabil sürümden önce değişebilir. Production'da tam sürümü sabitleyin ve güncellemeden önce değişiklik günlüğüne bakın.

Ortam değişkenleri

Sağlayıcı kimlik bilgilerinizle bir .env.local (ya da .env) dosyası oluşturun:

# iyzico
IYZICO_API_KEY=your-api-key
IYZICO_SECRET_KEY=your-secret-key

# PayTR (Mağaza Paneli > Bilgi)
PAYTR_MERCHANT_ID=your-merchant-id
PAYTR_MERCHANT_KEY=your-merchant-key
PAYTR_MERCHANT_SALT=your-merchant-salt

# Akbank Sanal POS
AKBANK_MERCHANT_SAFE_ID=your-merchant-safe-id
AKBANK_TERMINAL_SAFE_ID=your-terminal-safe-id
AKBANK_SECRET_KEY=your-secret-key

# Parampos
PARAMPOS_CLIENT_CODE=your-client-code
PARAMPOS_CLIENT_USERNAME=your-username
PARAMPOS_CLIENT_PASSWORD=your-password
PARAMPOS_GUID=your-guid

Kimlik bilgilerini asla sürüm kontrolüne eklemeyin. Onları ortam değişkenlerinde tutun ve .env dosyasının .gitignore içinde olduğundan emin olun.

Kurulumu doğrulayın

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

const payment = betterPayment({
  mode: 'sandbox',
  providers: {
    iyzico: iyzico({ apiKey: 'test', secretKey: 'test' }),
  },
});

console.log(VERSION, payment.getEnabledProviders()); // '0.11.0' ['iyzico']

On this page