1.0.0 • Published 4 months ago
esnekpos v1.0.0
EsnekPOS Node.js Entegrasyonu
EsnekPOS ödeme sisteminin Node.js uygulamaları için resmi olmayan istemci kütüphanesi. Bu kütüphane ile EsnekPOS API'lerini kolayca kullanabilirsiniz.
Kurulum
npm install esnekpos
Kullanım
İstemci Oluşturma
const esnekpos = require('esnekpos');
const client = esnekpos.createClient({
merchant: 'MERCHANT_ID',
merchantKey: 'MERCHANT_KEY',
testMode: true // Test ortamı için true, gerçek ortam için false
});
3D Ödeme Alma
async function create3DPayment() {
try {
const payment = await client.payment.create3DPayment({
Config: {
BACK_URL: 'https://example.com/callback',
PRICES_CURRENCY: 'TRY',
ORDER_REF_NUMBER: 'ORDER_12345',
ORDER_AMOUNT: '100.00'
},
CreditCard: {
CC_NUMBER: '4159562885391991',
EXP_MONTH: '12',
EXP_YEAR: '2025',
CC_CVV: '123',
CC_OWNER: 'John Doe',
INSTALLMENT_NUMBER: '1'
},
Customer: {
FIRST_NAME: 'John',
LAST_NAME: 'Doe',
MAIL: 'john@example.com',
PHONE: '5321234567',
CITY: 'Istanbul',
STATE: 'Kadikoy',
ADDRESS: 'Test Address',
CLIENT_IP: '127.0.0.1'
},
Product: [
{
PRODUCT_ID: '1',
PRODUCT_NAME: 'Test Product',
PRODUCT_CATEGORY: 'Electronics',
PRODUCT_DESCRIPTION: 'Test Description',
PRODUCT_AMOUNT: '100.00'
}
]
});
console.log('Ödeme başarıyla başlatıldı:', payment);
// URL_3DS alanıyla müşteriyi 3D doğrulama sayfasına yönlendirin
return payment;
} catch (error) {
console.error('Ödeme başlatma hatası:', error);
throw error;
}
}
Ortak Ödeme Sayfası
async function createCommonPayment() {
try {
const payment = await client.payment.createCommonPayment({
Config: {
ORDER_REF_NUMBER: 'ORDER_12345',
ORDER_AMOUNT: '100.00',
PRICES_CURRENCY: 'TRY',
BACK_URL: 'https://example.com/callback',
LOCALE: 'tr'
},
Customer: {
FIRST_NAME: 'John',
LAST_NAME: 'Doe',
MAIL: 'john@example.com',
PHONE: '5321234567',
CITY: 'Istanbul',
STATE: 'Kadikoy',
ADDRESS: 'Test Address'
},
Product: [
{
PRODUCT_ID: '1',
PRODUCT_NAME: 'Test Product',
PRODUCT_CATEGORY: 'Electronics',
PRODUCT_DESCRIPTION: 'Test Description',
PRODUCT_AMOUNT: '100.00'
}
]
});
console.log('Ödeme sayfası başarıyla oluşturuldu:', payment);
// URL_3DS alanıyla müşteriyi ödeme sayfasına yönlendirin
return payment;
} catch (error) {
console.error('Ödeme sayfası oluşturma hatası:', error);
throw error;
}
}
İşlem Sorgulama
async function queryTransaction(orderRefNumber) {
try {
const result = await client.query.queryTransaction(orderRefNumber);
console.log('İşlem detayları:', result);
return result;
} catch (error) {
console.error('İşlem sorgulama hatası:', error);
throw error;
}
}
İade/İptal İşlemi
async function refundTransaction(orderRefNumber, amount) {
try {
const result = await client.refund.refundTransaction({
orderRefNumber,
amount,
syncWithPos: true // Banka ile senkron işlem için true
});
console.log('İade sonucu:', result);
return result;
} catch (error) {
console.error('İade işlemi hatası:', error);
throw error;
}
}
Desteklenen Özellikler
- 3D Ödeme İşlemleri
- Ortak Ödeme Sayfası
- BKM Express Ödemeleri
- İşlem Sorgulama ve Listeleme
- İade/İptal İşlemleri
- Tekrarlı Ödeme İşlemleri
- Pazaryeri Entegrasyonu (Alt üye işyeri işlemleri)
- Fiziksel POS İşlemleri
Test Ortamı
Test ortamında geliştirme yapmak için testMode parametresini true olarak ayarlayın ve EsnekPOS tarafından sağlanan test kartlarını kullanın.
Test Kartı
Kart No: 4159562885391991
Son Kullanma: 12/2025
CVV: 123
Lisans
MIT
1.0.0
4 months ago