paytr.js 0.0.2 → 0.0.5

package/README.md

@@ -59,6 +59,49 @@ const payment = paytr.preparePayment({
 // payment.token      -> PayTR token
 ```
 
+### Direct API (Server-Side Ödeme)
+
+⚠️ **DİKKAT:** Bu yöntem PCI-DSS uyumluluğu gerektirir!
+
+```typescript
+// Kart bilgileri ile server-side ödeme
+const result = await paytr.processDirectPayment({
+  merchantOid: `ORDER-${Date.now()}`,
+  email: 'musteri@example.com',
+  paymentAmount: 100.99,
+  currency: 'TL',
+  basketItems: [{ name: 'Ürün', price: 100.99, quantity: 1 }],
+  user: { 
+    name: 'Müşteri Adı', 
+    address: 'Müşteri Adresi', 
+    phone: '05551234567' 
+  },
+  merchantOkUrl: 'https://site.com/odeme/basarili',
+  merchantFailUrl: 'https://site.com/odeme/hata',
+  cardInfo: {
+    ccOwner: 'KART SAHİBİ ADI',
+    cardNumber: '9792030394440796',
+    expiryMonth: '12',
+    expiryYear: '25',
+    cvv: '000'
+  }
+});
+
+if (result.status === 'redirect') {
+  // 3D Secure yönlendirmesi - HTML'i kullanıcıya göster
+  return new Response(result.redirectHtml, { 
+    headers: { 'Content-Type': 'text/html' } 
+  });
+} else if (result.status === 'success') {
+  // Ödeme başarılı (non-3D)
+  console.log('Ödeme tamamlandı!');
+} else {
+  // Hata
+  console.error('Hata:', result.errMsg);
+}
+```
+
+
 ### Ödeme Callback Doğrulama
 
 ```typescript
@@ -212,6 +255,112 @@ if (result.status === 'success') {
 }
 ```
 
+### Platform Transfer (Marketplace)
+
+#### Transfer İşlemi
+
+```typescript
+// Alt mağazaya ödeme transferi
+const result = await paytr.platformTransfer({
+  merchantOid: 'ORDER-123',
+  transId: 'TRANS-456',
+  submerchantAmount: 8000,  // 80.00 TL (kuruş cinsinden)
+  totalAmount: 10000,       // 100.00 TL (kuruş cinsinden)
+  transferName: 'Alt Mağaza Adı',
+  transferIban: 'TR123456789012345678901234'
+});
+
+if (result.status === 'success') {
+  console.log('Transfer başarılı');
+} else {
+  console.error('Hata:', result.err_msg);
+}
+```
+
+#### Geri Dönen Ödemeler Listesi
+
+```typescript
+const startDate = new Date('2024-01-01');
+const endDate = new Date('2024-01-31');
+
+const result = await paytr.getReturnedPayments(startDate, endDate);
+
+if (result.status === 'success' && result.data) {
+  result.data.forEach(payment => {
+    console.log(`${payment.merchant_oid}: ${payment.amount} - ${payment.return_reason}`);
+  });
+}
+```
+
+#### Geri Dönen Ödemeyi Transfer Et
+
+```typescript
+const result = await paytr.sendReturnedPayment('TRANS-123', [
+  {
+    trans_id: 'SUB-1',
+    submerchant_amount: 5000,
+    transfer_name: 'Alt Mağaza 1',
+    transfer_iban: 'TR123456789012345678901234'
+  },
+  {
+    trans_id: 'SUB-2',
+    submerchant_amount: 3000,
+    transfer_name: 'Alt Mağaza 2',
+    transfer_iban: 'TR987654321098765432109876'
+  }
+]);
+```
+
+#### Platform Transfer Callback Doğrulama
+
+```typescript
+// Express.js / Next.js API Route
+app.post('/api/platform-callback', (req, res) => {
+  const isValid = paytr.verifyPlatformTransferCallback(req.body);
+  
+  if (!isValid) {
+    return res.status(400).send('Invalid hash');
+  }
+  
+  // Transfer işlemini onayla
+  res.send('OK');
+});
+```
+
+### Ödeme Raporları
+
+#### Ödeme Özeti
+
+```typescript
+const startDate = new Date('2024-01-01');
+const endDate = new Date('2024-01-31');
+
+const result = await paytr.getPaymentSummary(startDate, endDate);
+
+if (result.status === 'success') {
+  console.log('Toplam Ödeme:', result.total_count);
+  console.log('Başarılı:', result.success_count);
+  console.log('Başarısız:', result.failed_count);
+  console.log('Toplam Tutar:', result.total_amount);
+}
+```
+
+#### Günlük Ödeme Detayı
+
+```typescript
+const date = new Date('2024-01-15');
+
+const result = await paytr.getPaymentDetail(date);
+
+if (result.status === 'success' && result.data) {
+  result.data.forEach(payment => {
+    console.log(`${payment.merchant_oid}: ${payment.payment_amount} ${payment.currency}`);
+    console.log(`Durum: ${payment.payment_status}`);
+    console.log(`Taksit: ${payment.installment_count}`);
+  });
+}
+```
+
 ## 🔧 Next.js / Nuxt Entegrasyonu
 
 ### Next.js API Route
@@ -284,6 +433,7 @@ export default defineEventHandler(async (event) => {
 | `prepareSaveCardPayment(options)` | Kart saklayarak ödeme formu hazırlar |
 | `prepareStoredCardPayment(options)` | Kayıtlı kart ile ödeme formu hazırlar |
 | `prepareRecurringPayment(options)` | Tekrarlı ödeme formu hazırlar |
+| `processDirectPayment(options)` | Server-side direkt ödeme işlemi yapar |
 | `verifyCallback(callback)` | Ödeme bildirimini doğrular |
 | `queryBIN(binNumber)` | BIN sorgulama yapar |
 | `refund(merchantOid, amount, referenceNo?)` | İade işlemi yapar |
@@ -292,6 +442,12 @@ export default defineEventHandler(async (event) => {
 | `deleteCard(utoken, ctoken)` | Kayıtlı kartı siler |
 | `getOrderStatus(merchantOid)` | Sipariş durumu sorgular |
 | `getInstallmentRates()` | Taksit oranlarını getirir |
+| `platformTransfer(params)` | Platform transfer işlemi yapar (Marketplace) |
+| `getReturnedPayments(startDate, endDate)` | Geri dönen ödemeleri listeler |
+| `sendReturnedPayment(transId, transfers)` | Geri dönen ödemeyi transfer eder |
+| `verifyPlatformTransferCallback(callback)` | Platform transfer callback'ini doğrular |
+| `getPaymentSummary(startDate, endDate)` | Ödeme özeti raporunu getirir |
+| `getPaymentDetail(date)` | Belirli bir günün ödeme detaylarını getirir |
 
 ## 📝 Test Kartı
 

package/dist/constants.d.ts

@@ -21,6 +21,16 @@ export declare const ENDPOINTS: {
     readonly ORDER_STATUS: "https://www.paytr.com/odeme/durum-sorgu";
     /** Taksit oranları */
     readonly INSTALLMENT_RATES: "https://www.paytr.com/odeme/taksit-oranlari";
+    /** Platform transfer */
+    readonly PLATFORM_TRANSFER: "https://www.paytr.com/odeme/platform/transfer";
+    /** Geri dönen ödemeler listesi */
+    readonly RETURNED_PAYMENTS: "https://www.paytr.com/odeme/geri-donen-transfer";
+    /** Hesaptan gönder */
+    readonly SEND_FROM_ACCOUNT: "https://www.paytr.com/odeme/hesaptan-gonder";
+    /** Ödeme dökümü */
+    readonly PAYMENT_SUMMARY: "https://www.paytr.com/rapor/odeme-dokumu";
+    /** Ödeme detayı */
+    readonly PAYMENT_DETAIL: "https://www.paytr.com/rapor/odeme-detayi";
 };
 /** Varsayılan değerler */
 export declare const DEFAULTS: {

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,0BAA0B;AAC1B,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,2BAA2B;;IAG3B,iBAAiB;;IAGjB,qBAAqB;;IAGrB,sBAAsB;;CAEd,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,QAAQ;IACnB,qBAAqB;;IAGrB,6BAA6B;;IAG7B,4BAA4B;;IAG5B,uCAAuC;;IAGvC,wBAAwB;;IAGxB,uBAAuB;;IAGvB,wBAAwB;;CAEhB,CAAC;AAEX,mBAAmB;AACnB,eAAO,MAAM,OAAO;;CAEV,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,0BAA0B;AAC1B,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,2BAA2B;;IAG3B,iBAAiB;;IAGjB,qBAAqB;;IAGrB,sBAAsB;;IAItB,wBAAwB;;IAExB,kCAAkC;;IAElC,sBAAsB;;IAItB,mBAAmB;;IAEnB,mBAAmB;;CAEX,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,QAAQ;IACnB,qBAAqB;;IAGrB,6BAA6B;;IAG7B,4BAA4B;;IAG5B,uCAAuC;;IAGvC,wBAAwB;;IAGxB,uBAAuB;;IAGvB,wBAAwB;;CAEhB,CAAC;AAEX,mBAAmB;AACnB,eAAO,MAAM,OAAO;;CAEV,CAAC"}

package/dist/constants.js

@@ -24,6 +24,18 @@ exports.ENDPOINTS = {
     ORDER_STATUS: `${exports.PAYTR_BASE_URL}/odeme/durum-sorgu`,
     /** Taksit oranları */
     INSTALLMENT_RATES: `${exports.PAYTR_BASE_URL}/odeme/taksit-oranlari`,
+    // Platform Transfer (Marketplace)
+    /** Platform transfer */
+    PLATFORM_TRANSFER: `${exports.PAYTR_BASE_URL}/odeme/platform/transfer`,
+    /** Geri dönen ödemeler listesi */
+    RETURNED_PAYMENTS: `${exports.PAYTR_BASE_URL}/odeme/geri-donen-transfer`,
+    /** Hesaptan gönder */
+    SEND_FROM_ACCOUNT: `${exports.PAYTR_BASE_URL}/odeme/hesaptan-gonder`,
+    // Payment Reports
+    /** Ödeme dökümü */
+    PAYMENT_SUMMARY: `${exports.PAYTR_BASE_URL}/rapor/odeme-dokumu`,
+    /** Ödeme detayı */
+    PAYMENT_DETAIL: `${exports.PAYTR_BASE_URL}/rapor/odeme-detayi`,
 };
 /** Varsayılan değerler */
 exports.DEFAULTS = {

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yBAAyB;AACZ,QAAA,cAAc,GAAG,uBAAuB,CAAC;AAEtD,0BAA0B;AACb,QAAA,SAAS,GAAG;IACvB,iCAAiC;IACjC,YAAY,EAAE,GAAG,sBAAc,QAAQ;IAEvC,oBAAoB;IACpB,SAAS,EAAE,GAAG,sBAAc,uBAAuB;IAEnD,kBAAkB;IAClB,MAAM,EAAE,GAAG,sBAAc,aAAa;IAEtC,mBAAmB;IACnB,eAAe,EAAE,GAAG,sBAAc,qBAAqB;IAEvD,2BAA2B;IAC3B,SAAS,EAAE,GAAG,sBAAc,kBAAkB;IAE9C,iBAAiB;IACjB,WAAW,EAAE,GAAG,sBAAc,oBAAoB;IAElD,qBAAqB;IACrB,YAAY,EAAE,GAAG,sBAAc,oBAAoB;IAEnD,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,sBAAc,wBAAwB;CACpD,CAAC;AAEX,0BAA0B;AACb,QAAA,QAAQ,GAAG;IACtB,qBAAqB;IACrB,QAAQ,EAAE,IAAa;IAEvB,6BAA6B;IAC7B,QAAQ,EAAE,IAAa;IAEvB,4BAA4B;IAC5B,YAAY,EAAE,MAAe;IAE7B,uCAAuC;IACvC,iBAAiB,EAAE,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,KAAK;IAEjB,uBAAuB;IACvB,SAAS,EAAE,KAAK;IAEhB,wBAAwB;IACxB,MAAM,EAAE,KAAK;CACL,CAAC;AAEX,mBAAmB;AACN,QAAA,OAAO,GAAG;IACrB,cAAc,EAAE,mCAAmC;CAC3C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yBAAyB;AACZ,QAAA,cAAc,GAAG,uBAAuB,CAAC;AAEtD,0BAA0B;AACb,QAAA,SAAS,GAAG;IACvB,iCAAiC;IACjC,YAAY,EAAE,GAAG,sBAAc,QAAQ;IAEvC,oBAAoB;IACpB,SAAS,EAAE,GAAG,sBAAc,uBAAuB;IAEnD,kBAAkB;IAClB,MAAM,EAAE,GAAG,sBAAc,aAAa;IAEtC,mBAAmB;IACnB,eAAe,EAAE,GAAG,sBAAc,qBAAqB;IAEvD,2BAA2B;IAC3B,SAAS,EAAE,GAAG,sBAAc,kBAAkB;IAE9C,iBAAiB;IACjB,WAAW,EAAE,GAAG,sBAAc,oBAAoB;IAElD,qBAAqB;IACrB,YAAY,EAAE,GAAG,sBAAc,oBAAoB;IAEnD,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,sBAAc,wBAAwB;IAE5D,kCAAkC;IAClC,wBAAwB;IACxB,iBAAiB,EAAE,GAAG,sBAAc,0BAA0B;IAC9D,kCAAkC;IAClC,iBAAiB,EAAE,GAAG,sBAAc,4BAA4B;IAChE,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,sBAAc,wBAAwB;IAE5D,kBAAkB;IAClB,mBAAmB;IACnB,eAAe,EAAE,GAAG,sBAAc,qBAAqB;IACvD,mBAAmB;IACnB,cAAc,EAAE,GAAG,sBAAc,qBAAqB;CAC9C,CAAC;AAEX,0BAA0B;AACb,QAAA,QAAQ,GAAG;IACtB,qBAAqB;IACrB,QAAQ,EAAE,IAAa;IAEvB,6BAA6B;IAC7B,QAAQ,EAAE,IAAa;IAEvB,4BAA4B;IAC5B,YAAY,EAAE,MAAe;IAE7B,uCAAuC;IACvC,iBAAiB,EAAE,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,KAAK;IAEjB,uBAAuB;IACvB,SAAS,EAAE,KAAK;IAEhB,wBAAwB;IACxB,MAAM,EAAE,KAAK;CACL,CAAC;AAEX,mBAAmB;AACN,QAAA,OAAO,GAAG;IACrB,cAAc,EAAE,mCAAmC;CAC3C,CAAC"}

package/dist/esm/constants.d.ts

@@ -21,6 +21,16 @@ export declare const ENDPOINTS: {
     readonly ORDER_STATUS: "https://www.paytr.com/odeme/durum-sorgu";
     /** Taksit oranları */
     readonly INSTALLMENT_RATES: "https://www.paytr.com/odeme/taksit-oranlari";
+    /** Platform transfer */
+    readonly PLATFORM_TRANSFER: "https://www.paytr.com/odeme/platform/transfer";
+    /** Geri dönen ödemeler listesi */
+    readonly RETURNED_PAYMENTS: "https://www.paytr.com/odeme/geri-donen-transfer";
+    /** Hesaptan gönder */
+    readonly SEND_FROM_ACCOUNT: "https://www.paytr.com/odeme/hesaptan-gonder";
+    /** Ödeme dökümü */
+    readonly PAYMENT_SUMMARY: "https://www.paytr.com/rapor/odeme-dokumu";
+    /** Ödeme detayı */
+    readonly PAYMENT_DETAIL: "https://www.paytr.com/rapor/odeme-detayi";
 };
 /** Varsayılan değerler */
 export declare const DEFAULTS: {

package/dist/esm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,0BAA0B;AAC1B,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,2BAA2B;;IAG3B,iBAAiB;;IAGjB,qBAAqB;;IAGrB,sBAAsB;;CAEd,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,QAAQ;IACnB,qBAAqB;;IAGrB,6BAA6B;;IAG7B,4BAA4B;;IAG5B,uCAAuC;;IAGvC,wBAAwB;;IAGxB,uBAAuB;;IAGvB,wBAAwB;;CAEhB,CAAC;AAEX,mBAAmB;AACnB,eAAO,MAAM,OAAO;;CAEV,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,0BAA0B;AAC1B,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,2BAA2B;;IAG3B,iBAAiB;;IAGjB,qBAAqB;;IAGrB,sBAAsB;;IAItB,wBAAwB;;IAExB,kCAAkC;;IAElC,sBAAsB;;IAItB,mBAAmB;;IAEnB,mBAAmB;;CAEX,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,QAAQ;IACnB,qBAAqB;;IAGrB,6BAA6B;;IAG7B,4BAA4B;;IAG5B,uCAAuC;;IAGvC,wBAAwB;;IAGxB,uBAAuB;;IAGvB,wBAAwB;;CAEhB,CAAC;AAEX,mBAAmB;AACnB,eAAO,MAAM,OAAO;;CAEV,CAAC"}

package/dist/esm/constants.js

@@ -21,6 +21,18 @@ export const ENDPOINTS = {
     ORDER_STATUS: `${PAYTR_BASE_URL}/odeme/durum-sorgu`,
     /** Taksit oranları */
     INSTALLMENT_RATES: `${PAYTR_BASE_URL}/odeme/taksit-oranlari`,
+    // Platform Transfer (Marketplace)
+    /** Platform transfer */
+    PLATFORM_TRANSFER: `${PAYTR_BASE_URL}/odeme/platform/transfer`,
+    /** Geri dönen ödemeler listesi */
+    RETURNED_PAYMENTS: `${PAYTR_BASE_URL}/odeme/geri-donen-transfer`,
+    /** Hesaptan gönder */
+    SEND_FROM_ACCOUNT: `${PAYTR_BASE_URL}/odeme/hesaptan-gonder`,
+    // Payment Reports
+    /** Ödeme dökümü */
+    PAYMENT_SUMMARY: `${PAYTR_BASE_URL}/rapor/odeme-dokumu`,
+    /** Ödeme detayı */
+    PAYMENT_DETAIL: `${PAYTR_BASE_URL}/rapor/odeme-detayi`,
 };
 /** Varsayılan değerler */
 export const DEFAULTS = {

package/dist/esm/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iCAAiC;IACjC,YAAY,EAAE,GAAG,cAAc,QAAQ;IAEvC,oBAAoB;IACpB,SAAS,EAAE,GAAG,cAAc,uBAAuB;IAEnD,kBAAkB;IAClB,MAAM,EAAE,GAAG,cAAc,aAAa;IAEtC,mBAAmB;IACnB,eAAe,EAAE,GAAG,cAAc,qBAAqB;IAEvD,2BAA2B;IAC3B,SAAS,EAAE,GAAG,cAAc,kBAAkB;IAE9C,iBAAiB;IACjB,WAAW,EAAE,GAAG,cAAc,oBAAoB;IAElD,qBAAqB;IACrB,YAAY,EAAE,GAAG,cAAc,oBAAoB;IAEnD,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,cAAc,wBAAwB;CACpD,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,qBAAqB;IACrB,QAAQ,EAAE,IAAa;IAEvB,6BAA6B;IAC7B,QAAQ,EAAE,IAAa;IAEvB,4BAA4B;IAC5B,YAAY,EAAE,MAAe;IAE7B,uCAAuC;IACvC,iBAAiB,EAAE,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,KAAK;IAEjB,uBAAuB;IACvB,SAAS,EAAE,KAAK;IAEhB,wBAAwB;IACxB,MAAM,EAAE,KAAK;CACL,CAAC;AAEX,mBAAmB;AACnB,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,cAAc,EAAE,mCAAmC;CAC3C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iCAAiC;IACjC,YAAY,EAAE,GAAG,cAAc,QAAQ;IAEvC,oBAAoB;IACpB,SAAS,EAAE,GAAG,cAAc,uBAAuB;IAEnD,kBAAkB;IAClB,MAAM,EAAE,GAAG,cAAc,aAAa;IAEtC,mBAAmB;IACnB,eAAe,EAAE,GAAG,cAAc,qBAAqB;IAEvD,2BAA2B;IAC3B,SAAS,EAAE,GAAG,cAAc,kBAAkB;IAE9C,iBAAiB;IACjB,WAAW,EAAE,GAAG,cAAc,oBAAoB;IAElD,qBAAqB;IACrB,YAAY,EAAE,GAAG,cAAc,oBAAoB;IAEnD,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,cAAc,wBAAwB;IAE5D,kCAAkC;IAClC,wBAAwB;IACxB,iBAAiB,EAAE,GAAG,cAAc,0BAA0B;IAC9D,kCAAkC;IAClC,iBAAiB,EAAE,GAAG,cAAc,4BAA4B;IAChE,sBAAsB;IACtB,iBAAiB,EAAE,GAAG,cAAc,wBAAwB;IAE5D,kBAAkB;IAClB,mBAAmB;IACnB,eAAe,EAAE,GAAG,cAAc,qBAAqB;IACvD,mBAAmB;IACnB,cAAc,EAAE,GAAG,cAAc,qBAAqB;CAC9C,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,qBAAqB;IACrB,QAAQ,EAAE,IAAa;IAEvB,6BAA6B;IAC7B,QAAQ,EAAE,IAAa;IAEvB,4BAA4B;IAC5B,YAAY,EAAE,MAAe;IAE7B,uCAAuC;IACvC,iBAAiB,EAAE,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,KAAK;IAEjB,uBAAuB;IACvB,SAAS,EAAE,KAAK;IAEhB,wBAAwB;IACxB,MAAM,EAAE,KAAK;CACL,CAAC;AAEX,mBAAmB;AACnB,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,cAAc,EAAE,mCAAmC;CAC3C,CAAC"}

package/dist/esm/index.d.ts

@@ -27,7 +27,7 @@
  * });
  * ```
  */
-import type { PayTRConfig, PaymentOptions, SaveCardPaymentOptions, StoredCardPaymentOptions, RecurringPaymentOptions, PreparedPayment, PaymentCallback, BINQueryResult, RefundResult, TransactionLogResult, CardListResult, DeleteCardResult, OrderStatusResult, InstallmentRatesResult } from './types';
+import type { PayTRConfig, PaymentOptions, SaveCardPaymentOptions, StoredCardPaymentOptions, RecurringPaymentOptions, PreparedPayment, PaymentCallback, BINQueryResult, RefundResult, TransactionLogResult, CardListResult, DeleteCardResult, OrderStatusResult, InstallmentRatesResult, DirectPaymentResult, CardInfo, PlatformTransferParams, PlatformTransferResult, ReturnedPaymentsResult, ReturnedPaymentTransfer, PlatformTransferCallback, PaymentSummaryResult, PaymentDetailResult } from './types';
 /**
  * PayTR SDK ana sınıfı
  */
@@ -212,6 +212,150 @@ export declare class PayTR {
      * ```
      */
     getInstallmentRates(): Promise<InstallmentRatesResult>;
+    /**
+     * Direct API ile server-side ödeme işlemi yapar
+     *
+     * ⚠️ DİKKAT: Bu metod kart bilgilerini server üzerinden işler.
+     * PCI-DSS uyumluluğu gerektirir!
+     *
+     * @param options - Ödeme parametreleri (cardInfo zorunlu)
+     * @returns Ödeme sonucu veya 3D yönlendirme bilgisi
+     *
+     * @example
+     * ```typescript
+     * const result = await paytr.processDirectPayment({
+     *   merchantOid: 'ORDER-123',
+     *   email: 'customer@example.com',
+     *   paymentAmount: 100.99,
+     *   currency: 'TL',
+     *   basketItems: [{ name: 'Ürün', price: 100.99, quantity: 1 }],
+     *   user: { name: 'Ad Soyad', address: 'Adres', phone: '05551234567' },
+     *   merchantOkUrl: 'https://site.com/basarili',
+     *   merchantFailUrl: 'https://site.com/hata',
+     *   cardInfo: {
+     *     ccOwner: 'KART SAHİBİ',
+     *     cardNumber: '9792030394440796',
+     *     expiryMonth: '12',
+     *     expiryYear: '25',
+     *     cvv: '000'
+     *   }
+     * });
+     *
+     * if (result.status === 'redirect') {
+     *   // 3D Secure yönlendirmesi gerekli
+     *   // result.redirectHtml'i kullanıcıya göster
+     * } else if (result.status === 'success') {
+     *   // Ödeme başarılı (non-3D)
+     * }
+     * ```
+     */
+    processDirectPayment(options: PaymentOptions & {
+        cardInfo: CardInfo;
+    }): Promise<DirectPaymentResult>;
+    /**
+     * Platform transfer işlemi yapar (Marketplace)
+     *
+     * @param params - Transfer parametreleri
+     * @returns Transfer sonucu
+     *
+     * @example
+     * ```typescript
+     * const result = await paytr.platformTransfer({
+     *   merchantOid: 'ORDER-123',
+     *   transId: 'TRANS-456',
+     *   submerchantAmount: 8000, // 80.00 TL
+     *   totalAmount: 10000,      // 100.00 TL
+     *   transferName: 'Alt Mağaza',
+     *   transferIban: 'TR123456789012345678901234',
+     * });
+     * ```
+     */
+    platformTransfer(params: PlatformTransferParams): Promise<PlatformTransferResult>;
+    /**
+     * Geri dönen ödemeleri listeler
+     *
+     * @param startDate - Başlangıç tarihi
+     * @param endDate - Bitiş tarihi
+     * @returns Geri dönen ödemeler listesi
+     *
+     * @example
+     * ```typescript
+     * const start = new Date('2024-01-01');
+     * const end = new Date('2024-01-31');
+     * const result = await paytr.getReturnedPayments(start, end);
+     * ```
+     */
+    getReturnedPayments(startDate: Date, endDate: Date): Promise<ReturnedPaymentsResult>;
+    /**
+     * Geri dönen ödemeyi transfer eder
+     *
+     * @param transId - Transfer ID
+     * @param transfers - Transfer bilgileri listesi
+     * @returns İşlem sonucu
+     *
+     * @example
+     * ```typescript
+     * const result = await paytr.sendReturnedPayment('TRANS-123', [
+     *   {
+     *     trans_id: 'SUB-1',
+     *     submerchant_amount: 5000,
+     *     transfer_name: 'Alt Mağaza',
+     *     transfer_iban: 'TR123456789012345678901234',
+     *   }
+     * ]);
+     * ```
+     */
+    sendReturnedPayment(transId: string, transfers: ReturnedPaymentTransfer[]): Promise<PlatformTransferResult>;
+    /**
+     * Platform transfer callback'ini doğrular
+     *
+     * @param callback - PayTR'dan gelen callback verisi
+     * @returns Doğrulama başarılı mı?
+     *
+     * @example
+     * ```typescript
+     * app.post('/api/platform-callback', (req, res) => {
+     *   const isValid = paytr.verifyPlatformTransferCallback(req.body);
+     *   if (!isValid) {
+     *     return res.status(400).send('Invalid hash');
+     *   }
+     *   // İşlemi onayla
+     *   res.send('OK');
+     * });
+     * ```
+     */
+    verifyPlatformTransferCallback(callback: PlatformTransferCallback): boolean;
+    /**
+     * Ödeme özeti raporunu getirir
+     *
+     * @param startDate - Başlangıç tarihi
+     * @param endDate - Bitiş tarihi
+     * @returns Ödeme özeti
+     *
+     * @example
+     * ```typescript
+     * const start = new Date('2024-01-01');
+     * const end = new Date('2024-01-31');
+     * const result = await paytr.getPaymentSummary(start, end);
+     * console.log('Toplam:', result.total_amount);
+     * ```
+     */
+    getPaymentSummary(startDate: Date, endDate: Date): Promise<PaymentSummaryResult>;
+    /**
+     * Belirli bir günün ödeme detaylarını getirir
+     *
+     * @param date - Tarih
+     * @returns Ödeme detayları
+     *
+     * @example
+     * ```typescript
+     * const result = await paytr.getPaymentDetail(new Date('2024-01-15'));
+     * result.data?.forEach(payment => {
+     *   console.log(payment.merchant_oid, payment.payment_amount);
+     * });
+     * ```
+     */
+    getPaymentDetail(date: Date): Promise<PaymentDetailResult>;
 }
 export * from './types';
 export { ENDPOINTS, DEFAULTS } from './constants';

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAYH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAe/B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe;IAwDxD;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe;IAYxE;;;;;OAKG;IACH,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe;IAiB5E;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,eAAe;IAe1E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAgBlD;;;;;;;;;;;;;;OAcG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAe1D;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC;IA4BxB;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwBpF;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWxD;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB3E;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmBrE;;;;;;;;;;;;OAYG;IACG,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC;CA4B7D;AAGD,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}