# A55Pay SDK - Documentation
JavaScript SDK for payment integration with 3DS authentication, Device Data Collection and ThreatMetrix fingerprinting.
## 📦 Installation
Include the SDK in your HTML:
```html
```
## 🚀 Basic Usage
### PayV2 - Complete Payment with Authentication
```html
A55Pay SDK - Example
```
## 🛠️ Available Methods
### 1. A55Pay.payV2(config)
Main method for payments with complete authentication.
**Parameters:**
- `charge_uuid` (string, required): Transaction UUID
- `userData` (object, required): User and card data
- `onReady` (function, optional): Callback when SDK is ready
- `onSuccess` (function, optional): Success callback
- `onError` (function, optional): Error callback
### 2. A55Pay.authentication(config)
Tests authentication only without making payment.
```javascript
A55Pay.authentication({
transactionReference: "550e8400-e29b-41d4-a716-446655440000",
cardBrand: "Visa",
cardExpiryMonth: "12",
cardExpiryYear: "2028",
cardNumber: "4111111111111111",
onSuccess: function(result) {
console.log("Authentication completed:", result);
// result.sessionId can be used in payment
},
onError: function(error) {
console.log("Authentication error:", error);
}
});
```
### 3. A55Pay.getDeviceId()
Returns the current Device ID generated by ThreatMetrix.
```javascript
const deviceId = A55Pay.getDeviceId();
console.log("Device ID:", deviceId);
```
### 4. A55Pay.regenerateDeviceId()
Generates a new Device ID.
```javascript
const newDeviceId = A55Pay.regenerateDeviceId();
console.log("New Device ID:", newDeviceId);
```
## 📋 userData Structure
### Required Fields
```javascript
const userData = {
// Payer
payer_name: "Full Name",
payer_email: "email@example.com",
payer_tax_id: "000.000.000-00",
cell_phone: "(11) 99999-9999",
// Card
holder_name: "NAME ON CARD",
number: "0000000000000000",
expiry_month: "MM",
expiry_year: "YYYY",
ccv: "123", // OR card_cryptogram
// Alternative card
card_token: "card_token",
card_cryptogram: "3ds_cryptogram",
// Address
postal_code: "00000-000",
street: "Street Name",
address_number: "123",
neighborhood: "Neighborhood Name",
complement: "Apt 101",
city: "City Name",
state: "SP",
country: "BR"
// Shipping address (if different from billing)
shipping_postal_code: "00000-000",
shipping_street: "Shipping Street",
shipping_address_number: "456",
shipping_complement: "Block B",
shipping_neighborhood: "Shipping Neighborhood",
shipping_city: "Shipping City",
shipping_state: "RJ",
shipping_country: "BR"
};
```
## 🔄 Flow
1. **Initialization**: SDK loads ThreatMetrix and generates Device ID
2. **Authentication**: CyberSource Device Data Collection
3. **IP Collection**: Multiple methods (Ipify, HTTPBin, WebRTC)
4. **Send**: Complete payload to payment API
5. **3DS**: If needed, opens modal for authentication
6. **Result**: Success or error callback
## 🛡️ Security
- **ThreatMetrix**: Advanced device fingerprinting
- **CyberSource**: Device Data Collection for 3DS
- **3DS 2.0**: Strong authentication when needed
- **IP Detection**: Multiple methods for maximum compatibility
## 📞 Support
For questions or issues:
1. Check browser console logs
2. Test with provided examples
3. Use `authentication-test.html` file for isolated debugging