);
};
```
#### Supported Payment Methods
Customer data prefilling is supported by the following payment providers:
- **Stripe**: Pre-fills name, email, and full billing address in payment forms
- **Adyen**: Pre-fills cardholder name, email, and address fields for card payments
**Note**: All customer data fields are optional. The widget will pre-fill only the fields that are provided.
### Handling Redirects
For 3D Secure authentication, users may be redirected to their bank. Store the session token to ensure continuity:
```javascript
const userSessionToken =
sessionStorage.getItem('paymentSessionToken') || getCurrentUserToken();
sessionStorage.setItem('paymentSessionToken', userSessionToken);
const widget = window.paymentWidget.init({
userSessionToken,
// ... other config
onSuccess: (token, details, instrumentToken) => {
sessionStorage.removeItem('paymentSessionToken');
handlePaymentSuccess(token, details, instrumentToken);
}
});
```
### Error Handling
By default, the widget displays errors internally. For custom error handling, provide an `onError` callback - the widget will then suppress internal error display.
```javascript
const widget = window.paymentWidget.init({
// ... required config
onError: (error) => {
switch (error.code) {
case 'NETWORK_ERROR':
showBanner('Connection lost. Please check your internet.');
break;
case 'POLLING_TIMEOUT':
showBanner('Payment is taking too long. Please try again.');
break;
case 'PSP_ERROR':
showModal('Payment failed: ' + error.message);
break;
default:
showNotification(error.message, 'error');
}
console.error(`[${error.code}] ${error.message}`, {
traceId: error.traceId,
httpStatus: error.httpStatus
});
}
});
```
**Error Codes:**
| Code | Description | Example |
| --- | --- | --- |
| `VALIDATION_ERROR` | Invalid input or configuration | Missing fields, invalid format |
| `API_ERROR` | Payment gateway API error | Server error, invalid request |
| `PSP_ERROR` | Payment provider error | Card declined, insufficient funds |
| `NETWORK_ERROR` | Network connectivity issue | Offline, timeout, failed to fetch |
| `POLLING_TIMEOUT` | Payment status check timed out | Backend/PSP unresponsive |
| `GENERIC_ERROR` | Unclassified error | Unexpected exceptions |
**Initialization Errors** are thrown synchronously and should be caught with try/catch:
```javascript
try {
const widget = window.paymentWidget.init(config);
} catch (error) {
console.error('Widget initialization failed:', error.message);
}
```
### API Reference
```typescript
interface PaymentWidget {
init(config: PaymentConfig): PaymentWidgetInstance;
}
interface PaymentWidgetInstance {
destroy(): void;
submitPayment(): Promise