> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pcibooking.net/llms.txt
> Use this file to discover all available pages before exploring further.
# Payments Library Setup
> Install and initialize PCI Booking's JavaScript Payments Library. Script loading, configuration, and first render.
## Prerequisites
* A PCI Booking merchant account.
* Credentials configured for the payment methods you want to accept. Contact your PCI Booking account manager for setup.
## Installation
### npm
```bash theme={null}
npm install @pcibooking/ewallet
```
```javascript theme={null}
import eWallet from '@pcibooking/ewallet';
```
### CDN
```html theme={null}
```
The library exposes a global `eWallet` object when loaded via CDN.
## Create a Session
Before initializing the library, your server must create a [payment session](/api-reference/payments-library/create-session) with PCI Booking. The session defines the operation type (e.g. `TOKENIZE`, `CHARGE`) and returns a session token.
Pass the session token to your frontend to initialize the library.
```javascript Node.js theme={null}
const response = await fetch('https://service.pcibooking.net/api/eWalletOperation', {
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
operation: 'CHARGE',
mode: 'LIVE',
PaymentGatewayAccountId: 'my-gateway-credentials',
AllowedeWalletAccountIds: 'my-applepay,my-googlepay',
CurrencyCode: 'USD',
Amount: 99.99,
CountryCode: 'US',
AllowedBrands: 'visa,mastercard,amex',
CustomerEmail: 'customer@example.com',
merchantReference: 'ORDER-12345'
})
});
const { sessionId } = await response.json();
// Pass sessionId to your frontend
```
```python Python theme={null}
import requests
response = requests.post(
'https://service.pcibooking.net/api/eWalletOperation',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'operation': 'CHARGE',
'mode': 'LIVE',
'PaymentGatewayAccountId': 'my-gateway-credentials',
'AllowedeWalletAccountIds': 'my-applepay,my-googlepay',
'CurrencyCode': 'USD',
'Amount': 99.99,
'CountryCode': 'US',
'AllowedBrands': 'visa,mastercard,amex',
'CustomerEmail': 'customer@example.com',
'merchantReference': 'ORDER-12345'
}
)
session_id = response.json()['sessionId']
# Pass session_id to your frontend
```
## Minimal Working Example
```html theme={null}
Checkout
```
Session tokens are single-use. Create a new session for each checkout attempt.
## Server-Side Validation
After the customer completes the payment, your callback receives a result token. Send this token to your server and call the [Validate Operation](/api-reference/payments-library/validate-operation) endpoint to confirm the result is authentic.
```javascript Node.js theme={null}
// In your server endpoint that receives the result token from the frontend
async function validatePaymentResult(resultToken) {
const response = await fetch('https://service.pcibooking.net/api/eWalletOperation/validateResults', {
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'text/plain'
},
body: resultToken
});
const data = await response.json();
return data.valid; // true if the token is authentic
}
```
```python Python theme={null}
import requests
def validate_payment_result(result_token):
"""Call from your server after receiving the result token from the frontend."""
response = requests.post(
'https://service.pcibooking.net/api/eWalletOperation/validateResults',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'text/plain'
},
data=result_token
)
data = response.json()
return data['valid'] # True if the token is authentic
```
## Next Steps
See which methods are available and their supported operations
Full API surface: constructor parameters, all methods, UI options