@acmepayments/fraud-shield
v1.0.1
Published
ACME Fraud Shield is your key defense against bad actors when it comes to protecting your ticketing and events-based business from fraud. ACME Payments utilizes best-in-class technology and decisions on over 150 data signals in real-time to ensure that yo
Downloads
31
Readme
ACME Fraud Shield JavaScript SDK
ACME Fraud Shield is your key defense against bad actors when it comes to protecting your ticketing and events-based business from fraud. ACME Payments utilizes best-in-class technology and decisions on over 150 data signals in real-time to ensure that your customers have a safe and easy checkout experience. Shift your transactional risk liability and protect your online transactions today.
ACME Seller account required for API key access — get started today at [email protected].
Installation
ES Module
- Intended for use with modern bundlers like webpack.
- This is the recommended approach and will provide the best developer experience.
npm install @acmepayments/fraud-shield
UMD
UMD builds can be used directly in the browser via a <script>
tag.
Manually add the index.umd.js
script tag to the <head>
of your site.
<!-- Somewhere in your site's <head> -->
<script src="https://unpkg.com/@acmepayments/[email protected]/index.umd.js" async></script>
Usage (ES Module)
All of the examples also apply to the UMD version but instead of importing our library as an ES Module it will be available under the global
ACME
object.
const acmeFraudShield = window.ACME.ACMEFraudShield.create({
mid: 'your_mid', // Use your provided merchant identification number (MID)
publishableKey: 'your_publishable_key', // Use your provided publishable
});
Handle Decisioning Data Session
Required data fields to properly decision. Insufficient data may cause improper consumer identification or cause unnecessary friction in the transaction, forcing the user to return and retry.
import { ACMEFraudShield } from '@acmepayments/fraud-shield';
const acmeFraudShield = ACMEFraudShield.create({
mid: 'your_mid',
publishableKey: 'your_publishable_key',
});
try {
const result = await acmeFraudShield.handle3DSSession({
amount: '', // string, required
externalId: '', // string, optional
billingAddress1: '', // string, optional
billingAddress2: '', // string, optional
billingCity: '', // string, optional
billingState: '', // string, optional
billingCountryCode: 840, // ISO 3166-1 numeric, optional
billingFirstName: '', // string, required
billingLastName: '', // string, required
billingPostalCode: '', // string, required
billingPhone: '', // string, optional
cardExpMonth: '', // string, required
cardExpYear: '', // string, required
cardNumber: '', // string, required
email: '', // string, required
// This allows you to pass a custom container for the stepup iframe, it will default to `document.body`
// container: {
// selector: () => document.querySelector('...')
// }
});
} catch (error) {
// handle error
}