@paynext/sdk 0.0.33 → 0.0.35

package/README.md

@@ -13,7 +13,7 @@ npm install @paynext/sdk
 ```typescript
 import { PayNextCheckout, type PaymentResult } from '@paynext/sdk'
 
-const checkout = new PayNextCheckout(document.getElementById('checkout'))
+const checkout = new PayNextCheckout(document.getElementById('checkout-form'))
 
 await checkout.mount({
   clientToken: 'your-client-token',
@@ -30,7 +30,7 @@ await checkout.mount({
 
 ```tsx
 import { useEffect, useRef } from 'react'
-import { PayNextCheckout, PaymentResult } from '@paynext/sdk'
+import { PayNextCheckout, type PaymentResult } from '@paynext/sdk'
 
 // interface
 interface IProps {
@@ -44,6 +44,10 @@ export const CheckoutComponent: FC<Readonly<IProps> = (props) => {
   const checkoutRef = useRef<HTMLDivElement>(null)
 
   useEffect(() => {
+    if (!clientToken) {
+      return
+    }
+
     const checkout = new PayNextCheckout(checkoutRef.current)
     
     checkout.mount({
@@ -69,55 +73,17 @@ export const CheckoutComponent: FC<Readonly<IProps> = (props) => {
 
 ```typescript
 interface PayNextConfig {
-  clientToken: string                           // Required
-  supportedCardTypes?: CardType[]               // Optional: restrict card types
-  variant?: 'default' | 'compact'              // Optional: UI variant
-  locale?: string                               // Optional: language (en, de, fr, etc.)
+  clientToken: string             // Required
+  supportedCardTypes?: CardType[] // Optional: restrict card types
+  variant?: 'default' | 'compact' // Optional: UI variant
+  locale?: Locale                 // Optional: language (en, de, fr, etc.)
+  translate?: CheckoutTranslate   // Optional: custom translations
+  styles?: StylesConfig           // Optional: custom styles
   onCheckoutComplete?: (result: PaymentResult) => void
   onCheckoutFail?: (error: Error) => void
 }
 ```
 
-## Payment Result
-
-The `onCheckoutComplete` callback receives detailed payment information:
-
-```typescript
-interface PaymentResult {
-  paymentMethod: 'card' | 'apple_pay' | 'google_pay' | 'paypal'
-  transactionId?: string
-  clientSession: string
-  
-  paymentDetails?: {
-    card?: {
-      brand: string
-      lastFour: string
-      expMonth?: number
-      expYear?: number
-    }
-    // ... other payment method details
-  }
-  
-  billingAddress?: {
-    name?: string
-    line1?: string
-    city?: string
-    country?: string
-    // ... other address fields
-  }
-  
-  amount?: {
-    value: number        // Amount in cents
-    currency: string
-  }
-  
-  metadata?: {
-    timestamp: string
-    locale?: string
-  }
-}
-```
-
 ## Supported Payment Methods
 
 - **Cards**: Visa, Mastercard, American Express, Discover, JCB, Diners Club, UnionPay, Maestro
@@ -128,52 +94,19 @@ interface PaymentResult {
 
 English, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Czech, Slovak, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Estonian, Latvian, Lithuanian, Finnish, Swedish, Danish, Norwegian, Russian, Ukrainian, Arabic, Chinese, Japanese, Korean, Thai, Vietnamese, Indonesian, Malay, Filipino, Hindi, Turkish, Greek, Maltese.
 
-## Custom Styling
-
-```typescript
-await checkout.mount({
-  clientToken: 'your-token',
-  styles: {
-    card: {
-      input: {
-        field: {
-          styles: { fontSize: '16px', color: '#333' },
-          className: 'custom-input'
-        }
-      }
-    }
-  }
-})
-```
-
-## Error Handling
-
-```typescript
-await checkout.mount({
-  clientToken: 'your-token',
-  onCheckoutFail: (error: Error) => {
-    // Handle payment errors
-    switch (error.message) {
-      case 'invalid_card':
-        showMessage('Please check your card details')
-        break
-      case 'insufficient_funds':
-        showMessage('Insufficient funds')
-        break
-      default:
-        showMessage('Payment failed. Please try again.')
-    }
-  }
-})
-```
-
 ## TypeScript Support
 
 Full TypeScript support with comprehensive type definitions for all interfaces, payment methods, and configuration options.
 
 ## Browser Support
 
-Modern browsers including Chrome 90+, Firefox 88+, Safari 14+, Edge 90+.
+The SDK supports recent versions of all major browsers:
+
+- Chrome (v90+)
+- Safari (v14+)
+- Firefox (v88+)
+- Edge (v90+)
+- Android WebView / WKWebView (for in-app flows)
 
 ## Security
 

package/dist/index.d.ts

@@ -249,8 +249,8 @@ export declare type Locale = 'ar' | 'en' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'e
 
 export declare interface PaymentResult {
     paymentMethod: 'card' | 'apple_pay' | 'google_pay' | 'paypal';
-    transactionId?: string;
     clientSession: string;
+    status?: string;
     paymentDetails?: {
         card?: {
             brand: string;