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 sales@acmepayments.com.
- 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 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/fraud-shield@1.0.1/index.umd.js" async></script>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
ACMEobject.
const acmeFraudShield = window.ACME.ACMEFraudShield.create({
mid: 'your_mid', // Use your provided merchant identification number (MID)
publishableKey: 'your_publishable_key', // Use your provided publishable
});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
}