Neden Node.js ile SanalPos.com?
Node.js, olay odaklı ve bloklamayan I/O modeli ile yüksek performanslı ödeme işlemleri için ideal bir çalışma ortamı sunar.
Modern web uygulamalarının çoğu Node.js üzerinde çalışır ve SanalPos.com API'si bu ekosistemle mükemmel uyum sağlar. Node.js'in asenkron (async/await) yapısı, ödeme isteklerini paralel olarak işlemenize olanak tanır. Bu sayede yoğun trafik altında bile ödeme akışları kesintisiz çalışır ve sunucu kaynaklarınız verimli kullanılır. Büyük ölçekli e-ticaret platformları, SaaS uygulamaları ve marketplace projeleri için Node.js, düşük gecikme süresi ve yüksek verimlilik sunar.
npm ekosistemi dünyada en büyük paket havuzuna sahiptir ve SanalPos.com Node.js SDK'sı bu ekosistemin bir parçasıdır. Tek bir komutla projenize ekleyebilir, TypeScript tip tanımları sayesinde geliştirme sürecinizi hatasız ve hızlı yürütebilirsiniz. Express.js, Fastify ve NestJS gibi popüler framework'lerle sorunsuz çalışır; mevcut proje yapınıza kolayca adapte olur.
TypeScript ile tip güvenli entegrasyon, Express/Fastify/NestJS ile sorunsuz uyum ve kapsamlı sandbox ortamı sayesinde Node.js projelerinize ödeme altyapısını güvenle entegre edin.
1. SanalPos.com Hesabı Oluşturun
Ücretsiz başvuru yaparak API anahtarlarınızı edinin ve sandbox ortamına erişin.
2. npm Paketini Kurun
npm veya yarn ile SanalPos.com Node.js SDK'sını projenize ekleyin: npm install sanalpos-sdk
3. Ödeme Akışını Kodlayın
async/await ile ödeme başlatma, 3D Secure yönlendirme ve webhook işlemlerini kodlayın.
4. Test Edin ve Canlıya Alın
Sandbox ortamında tüm senaryoları test edin, ardından canlı API anahtarlarıyla production'a geçin.
Kurulum Adımları
Dört basit adımda Node.js uygulamanıza ödeme entegrasyonunu tamamlayın.
npm paketi ile kurulum, API anahtarlarınızı yapılandırma ve sandbox testlerinin ardından canlı ortama geçiş yapın. Tüm süreç boyunca detaylı dokümantasyon ve 7/24 teknik destek yanınızda.
SDK kullanmak zorunlu değil — doğrudan REST API ile de entegrasyon yapabilirsiniz.
Kod Örneği
Node.js ve Express ile ödeme başlatma örneği. REST API üzerinden basit bir ödeme isteği gönderin.
const express = require('express');
const app = express();
// Ödeme başlatma endpoint'i
app.post('/odeme-baslat', async (req, res) => {
try {
const response = await fetch('https://api.sanalpos.com/v1/payments', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 9999,
currency: 'TRY',
card: {
holderName: req.body.cardHolder,
number: req.body.cardNumber,
expMonth: req.body.expMonth,
expYear: req.body.expYear,
cvc: req.body.cvc
},
secure3d: true,
callbackUrl: 'https://siteadresiniz.com/odeme-sonuc'
})
});
const data = await response.json();
res.json(data);
} catch (error) {
res.status(500).json({ error: error.message });
}
});Bu örnek temel bir REST API çağrısını gösterir. Detaylı entegrasyon için SDK dokümantasyonuna bakın.
Node.js Entegrasyon Özellikleri
Node.js uygulamalarınız için sunulan ödeme altyapısı özellikleri.
npm Paketi
Kolay kurulum ve güncelleme
TypeScript Desteği
Tam tip tanımları dahil
REST API
Promise tabanlı API çağrıları
Sandbox Ortamı
Güvenli test ortamı
Webhook Desteği
Express/Fastify middleware
3D Secure
Güvenli ödeme doğrulaması
Teknik Gereksinimler
Node.js sanal POS entegrasyonu için gerekli ortam ve bileşenler.
Aşağıdaki gereksinimleri karşıladığınızdan emin olduktan sonra entegrasyon sürecine başlayabilirsiniz. Tüm gereksinimler standart Node.js geliştirme ortamlarında varsayılan olarak mevcuttur.
| Gereksinim | Değer |
|---|---|
| Node.js | 16.x veya üzeri |
| npm veya yarn | Paket yöneticisi |
| SSL Sertifikası | Gerekli (HTTPS) |
| SanalPos.com Hesabı | Ücretsiz başvuru |
Sıkça Sorulan Sorular
Node.js sanal POS entegrasyonu hakkında merak edilenler.
İlgili Sayfalar
Node.js Entegrasyonuna Hemen Başlayın
Taahhüt yok, gizli maliyet yok.
Yalnızca başarılı işlemler için komisyon ödersiniz.
Neden Bizi Tercih Etmelisiniz