Kill Bill OSGI Accertify plugin

Kill Bill Accertify plugin

License	Apache License 2.0
Categories	Java Languages
GroupId	org.kill-bill.billing.plugin.java
ArtifactId	accertify-plugin
Last Version	0.3.0
Release Date	Nov 17, 2016
Type	bundle
Description	Kill Bill OSGI Accertify plugin Kill Bill Accertify plugin
Project URL	http://github.com/killbill/killbill-accertify-plugin
Source Code Management	http://github.com/killbill/killbill-accertify-plugin/tree/master

Download accertify-plugin

Filename	Size
accertify-plugin-0.3.0.pom
accertify-plugin-0.3.0.jar	9 MB
accertify-plugin-0.3.0-tests.jar	13 KB
accertify-plugin-0.3.0-test-sources.jar	8 KB
accertify-plugin-0.3.0-sources.jar	7 MB
accertify-plugin-0.3.0-javadoc.jar	199 KB

Dependencies

provided (5)

Group / Artifact	Type	Version
com.google.code.findbugs : jsr305	jar	2.0.1
javax.servlet : javax.servlet-api	jar	3.1.0
javax.xml.stream : stax-api	jar	1.0-2
org.kill-bill.billing : killbill-api	jar	0.50
org.kill-bill.billing.plugin : killbill-plugin-api-control	jar	0.23

test (9)

Group / Artifact	Type	Version
mysql : mysql-connector-java	jar	5.1.33
mysql : mysql-connector-mxj	jar	5.0.12
mysql : mysql-connector-mxj-db-files	jar	5.0.12
org.kill-bill.billing.plugin.java : killbill-base-plugin	test-jar	1.1.0
org.kill-bill.commons : killbill-embeddeddb-common	jar	0.20
org.kill-bill.commons : killbill-embeddeddb-mysql	jar	0.20
org.kill-bill.commons : killbill-embeddeddb-mysql	test-jar	0.20
org.mockito : mockito-all	jar	1.10.19
org.testng : testng	jar	6.8.8

Project Modules

There are no modules declared in this project.

Accertify plugin

Kill Bill fraud plugin using Accertify.

Release builds are available on Maven Central with coordinates org.kill-bill.billing.plugin.java:accertify-plugin.

Kill Bill compatibility

Plugin version	Kill Bill version
0.1.y	0.14.z
0.2.y	0.16.z
0.3.y	0.18.z

Requirements

The plugin needs a database. The latest version of the schema can be found here.

Configuration

The following properties are required:

• org.killbill.billing.plugin.accertify.url: your Accertify url
• org.killbill.billing.plugin.accertify.username: your username
• org.killbill.billing.plugin.accertify.password: your password

The following properties are optional:

• org.killbill.billing.plugin.accertify.plugins: names of the payment plugins for which automatic rejection is enabled (separated by comma)
• org.killbill.billing.plugin.accertify.proxyHost: proxy host
• org.killbill.billing.plugin.accertify.proxyPort: proxy port
• org.killbill.billing.plugin.accertify.strictSSL: if false, unverified certificates are trusted

These properties can be specified globally via System Properties or on a per tenant basis:

curl -v \
     -X POST \
     -u admin:password \
     -H 'X-Killbill-ApiKey: bob' \
     -H 'X-Killbill-ApiSecret: lazar' \
     -H 'X-Killbill-CreatedBy: admin' \
     -H 'Content-Type: text/plain' \
     -d 'org.killbill.billing.plugin.accertify.url=XXX
org.killbill.billing.plugin.accertify.username=YYY
org.killbill.billing.plugin.accertify.password=ZZZ' \
     http://127.0.0.1:8080/1.0/kb/tenants/uploadPluginConfig/killbill-accertify

Usage

Accertify

Because your organization will have its own XML schema configured in Accertify, you need to pass relevant data for Accertify via plugin properties. Any property starting with accertify_ will be passed through, with the following naming convention:

• Single keys like accertify_ipAddress are passed as top elements in the <transaction> request element
• Composed keys like accertify_collectionTransaction->billingFirstName are passed as children elements
• Use brackets to create list elements: orderDetails->orderDetail[0]->shippingName

For example, the properties

• accertify_ipAddress=127.0.0.1
• accertify_collectionTransaction->billingFirstName=John
• accertify_orderDetails->orderDetail[0]->shippingName=John Doe

will produce the following XML:

<transactions>
  <transaction>
    <ipAddress>127.0.0.1</ipAddress>
    <collectionTransaction>
      <billingFirstName>John</billingFirstName>
    </collectionTransaction>
    <orderDetails>
      <orderDetail>
        <shippingName>John Doe</shippingName>
      </orderDetail>
    </orderDetails>
  </transaction>
</transactions>

By default, the plugin simply calls Accertify and stores the response. Automatic rejection of the payments needs to be enabled on a per payment plugin basis.

For example, if the plugins killbill-cybersource, killbill-paypal-express and killbill-bitpay are installed and you want to reject only payments going to CyberSource and PayPal, specify:

org.killbill.billing.plugin.accertify.plugins=killbill-cybersource,killbill-paypal-express

Any payment for these plugins for which the assessment is REJECT will be aborted.

Kill Bill

To enable the plugin on a per payment basis, use the controlPluginName query parameter:

curl -v \
     -X POST \
     -u admin:password \
     -H 'X-Killbill-ApiKey: bob' \
     -H 'X-Killbill-ApiSecret: lazar' \
     -H 'X-Killbill-CreatedBy: admin' \
     -H 'Content-Type: application/json' \
     --data-binary '{"transactionType":"AUTHORIZE","amount":"10","currency":"USD"}' \
     "http://127.0.0.1:8080/1.0/kb/accounts/2a55045a-ce1d-4344-942d-b825536328f9/payments?controlPluginName=killbill-accertify"

Kill Bill

Kill Bill has been the leading open-source platform for billing and payment since 2010.

Versions

Version
0.3.0 Nov 17, 2016
0.2.0 Dec 18, 2015
0.1.0 May 6, 2015
0.0.1 Jan 16, 2015