Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Plugin to use CyberSource as a gateway.

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

Kill Bill compatibility

Plugin version Kill Bill version
1.x.y 0.14.z
4.x.y 0.16.z
5.x.y 0.18.z


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


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 ':cybersource:
  - :account_id: "merchant_account_1"
    :login: "your-login"
    :password: "your-password"
  - :account_id: "merchant_account_2"
    :login: "your-login"
    :password: "your-password"' \

To go to production, create a cybersource.yml configuration file under /var/tmp/bundles/plugins/ruby/killbill-cybersource/x.y.z/ containing the following:

  :test: false

To use PostgreSQL:

  • Set the following Kill Bill property: org.killbill.osgi.system.bundle.export.packages.extra=org.postgresql
  • Update the on-disk CyberSource configuration file with this section:
  :adapter: postgresql


To store a credit card (note that CyberSource requires a full billing address, hence the various fields below):

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' \
     -d '{
       "pluginName": "killbill-cybersource",
       "pluginInfo": {
         "properties": [
             "key": "ccFirstName",
             "value": "John"
             "key": "ccLastName",
             "value": "Doe"
             "key": "address1",
             "value": "5th Street"
             "key": "city",
             "value": "San Francisco"
             "key": "zip",
             "value": "94111"
             "key": "state",
             "value": "CA"
             "key": "country",
             "value": "USA"
             "key": "ccExpirationMonth",
             "value": 12
             "key": "ccExpirationYear",
             "value": 2017
             "key": "ccNumber",
             "value": "4111111111111111"
     }' \

CyberSource also requires an email address during the payment call. The plugin will pull the one from the Kill Bill account. Alternatively, you can pass it as a plugin property:

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' \
     -d '{
       "transactionType": "AUTHORIZE",
       "amount": 5
     }' \

Plugin properties

Key Description
skip_gw If true, skip the call to CyberSource
payment_processor_account_id Config entry name of the merchant account to use
external_key_as_order_id If true, set the payment external key as the CyberSource order id
ignore_avs If true, ignore the results of AVS checking
ignore_cvv If true, ignore the results of CVN checking
cc_first_name Credit card holder first name
cc_last_name Credit card holder last name
cc_type Credit card brand
cc_expiration_month Credit card expiration month
cc_expiration_year Credit card expiration year
cc_verification_value CVC/CVV/CVN
email Purchaser email
address1 Billing address first line
address2 Billing address second line
city Billing address city
zip Billing address zip code
state Billing address state
country Billing address country
commerce_indicator Override the commerce indicator field
eci Network tokenization attribute
payment_cryptogram Network tokenization attribute
transaction_id Network tokenization attribute
payment_instrument_name ApplePay tokenization attribute
payment_network ApplePay tokenization attribute
transaction_identifier ApplePay tokenization attribute
source androidpay for AndroidPay or googlepay for GooglePay
force_validation If true, trigger a non-$0 auth to validate cards not supporting $0 auth
force_validation_amount Amount to use when force_validation is set
merchant_descriptor Merchant descriptor as {"name":"Merchant Name","contact":"8888888888"}
reconciliation_id Optional reconciliation id. CYBS will generate one if not present.


Plugin to use CyberSource as a gateway




No packages published


You can’t perform that action at this time.