Shopier Node.js

Shopier ödeme sistemi için Node.js/TypeScript kütüphanesi.

Kurulum

``bash
npm install shopier
`

Kullanım

$3

`javascript
const {
Shopier,
Buyer,
Address,
ProductType,
WebsiteIndex,
ShopierButtonRenderer
} = require('shopier');

// Shopier instance oluştur
const shopier = new Shopier('API_KEY', 'API_SECRET');

// Alıcı bilgilerini oluştur
const buyer = new Buyer({
id: '101',
name: 'Ahmet',
surname: 'Yılmaz',
email: 'ahmet@example.com',
phone: '5551234567',
});

// Adres bilgilerini oluştur
const address = new Address({
address: 'Atatürk Caddesi No: 123',
city: 'İstanbul',
country: 'Türkiye',
postcode: '34000',
});

// Parametreleri ayarla
const params = shopier.getParams();
params.setWebsiteIndex(WebsiteIndex.SITE_1);
params.setBuyer(buyer);
params.setAddress(address);
params.setOrderData('ORDER-12345', '150.00');
params.setProductData('Premium Üyelik', ProductType.DOWNLOADABLE_VIRTUAL);

// HTML çıktısını al
const renderer = new ShopierButtonRenderer(shopier);
const html = shopier.goWith(renderer);
`

$3

`typescript
import {
Shopier,
Buyer,
Address,
ProductType,
WebsiteIndex,
ShopierButtonRenderer
} from 'shopier';

$3

`typescript
import express from 'express';
import { Shopier, ShopierResponse, Buyer, Address } from 'shopier';

const app = express();
app.use(express.urlencoded({ extended: true }));

// Ödeme sayfası
app.get('/payment', (req, res) => {
const shopier = new Shopier('API_KEY', 'API_SECRET');

// ... parametreleri ayarla

const html = shopier.go();
res.send(html);
});

// Callback endpoint
app.post('/payment/callback', (req, res) => {
const response = ShopierResponse.fromPostData(req.body);

if (response.hasValidSignature('API_SECRET')) {
// Ödeme başarılı
console.log('Sipariş ID:', response.getPlatformOrderId());
} else {
// Geçersiz imza
res.status(400).send('Invalid signature');
}
});
`

$3

#### ShopierButtonRenderer
Shopier temalı buton ile ödeme formu.

`typescript
const renderer = new ShopierButtonRenderer(shopier);
renderer.setName('Öde'); // Buton metnini değiştir
`

#### AutoSubmitFormRenderer
Sayfa yüklendiğinde otomatik olarak ödeme sayfasına yönlendirir.

`typescript
const renderer = new AutoSubmitFormRenderer(shopier);
`

#### IframeRenderer
Ödeme formunu iframe içinde gösterir.

`typescript
const renderer = new IframeRenderer(shopier);
renderer.setWidth(600).setHeight(750).setCenter(true);
`

#### FormRenderer
Basit form render'ı.

`typescript
const renderer = new FormRenderer(shopier);
`

$3

`typescript
import { Currency } from 'shopier';

params.setCurrency(Currency.TL); // Türk Lirası
params.setCurrency(Currency.USD); // Amerikan Doları
params.setCurrency(Currency.EUR); // Euro
`

$3

`typescript
import { Language } from 'shopier';

params.setCurrentLanguage(Language.TR); // Türkçe
params.setCurrentLanguage(Language.EN); // İngilizce
`

$3

`typescript
import { ProductType } from 'shopier';

params.setProductData('Ürün', ProductType.REAL); // Fiziksel ürün
params.setProductData('Ürün', ProductType.DOWNLOADABLE_VIRTUAL); // Dijital ürün
params.setProductData('Ürün', ProductType.DEFAULT_TYPE); // Varsayılan
`

API Referansı

$3

| Metod | Açıklama |
|-------|----------|
| getParams() | ShopierParams instance'ını döndürür |
| go() | Otomatik submit HTML'i döndürür |
| goWith(renderer) | Renderer ile HTML döndürür |
| validateResponse(data) | Yanıt imzasını doğrular |
| calculateSignature() | İmzayı hesaplar |

$3

| Metod | Açıklama |
|-------|----------|
| setBuyer(buyer) | Alıcı bilgilerini ayarlar |
| setAddress(address) | Hem fatura hem kargo adresini ayarlar |
| setBillingAddress(address) | Fatura adresini ayarlar |
| setShippingAddress(address) | Kargo adresini ayarlar |
| setOrderData(orderId, total, callback?) | Sipariş bilgilerini ayarlar |
| setProductData(name, type?) | Ürün bilgilerini ayarlar |
| setCurrency(currency) | Para birimini ayarlar |
| setCurrentLanguage(language) | Dili ayarlar |
| setWebsiteIndex(index) | Website indexini ayarlar |

$3

| Metod | Açıklama |
|-------|----------|
| fromPostData(data) | POST verisinden instance oluşturur |
| hasValidSignature(secret) | İmzayı doğrular |
| isSuccess() | Ödeme başarılı mı? |
| getPlatformOrderId() | Sipariş ID'sini döndürür |
| getPaymentId() | Ödeme ID'sini döndürür |
| getInstallment()` | Taksit sayısını döndürür |

Lisans

MIT