https://github.com/killbill/killbill-forte-plugin
Plugin to use Forte as a gateway
https://github.com/killbill/killbill-forte-plugin
Last synced: 8 months ago
JSON representation
Plugin to use Forte as a gateway
- Host: GitHub
- URL: https://github.com/killbill/killbill-forte-plugin
- Owner: killbill
- License: apache-2.0
- Created: 2014-12-14T19:22:13.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2016-11-17T14:09:40.000Z (over 9 years ago)
- Last Synced: 2024-12-28T10:28:59.759Z (over 1 year ago)
- Language: Java
- Homepage: http://killbill.io
- Size: 74.2 KB
- Stars: 0
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
killbill-forte-plugin
======================
Plugin to use [Forte](http://www.forte.net/) as a gateway.
Release builds are available on [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.kill-bill.billing.plugin.java%22%20AND%20a%3A%22forte-plugin%22) with coordinates `org.kill-bill.billing.plugin.java:forte-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](https://github.com/killbill/killbill-forte-plugin/blob/master/src/main/resources/ddl.sql).
Configuration
-------------
The following properties are required:
* `org.killbill.billing.plugin.forte.merchantId`: your merchant id
* `org.killbill.billing.plugin.forte.password`: your password
* `org.killbill.billing.plugin.forte.host`: AGI host (e.g. www.paymentsgateway.net)
* `org.killbill.billing.plugin.forte.port`: AGI port (e.g. 6050)
* `org.killbill.billing.plugin.forte.apiLoginId`: your API login id
* `org.killbill.billing.plugin.forte.secureTransactionKey`: your transaction key
* `org.killbill.billing.plugin.forte.test`: _true_ to use the sandbox
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.forte.merchantId=AAA
org.killbill.billing.plugin.forte.password=BBB
org.killbill.billing.plugin.forte.host=CCC
org.killbill.billing.plugin.forte.port=DDD
org.killbill.billing.plugin.forte.apiLoginId=EEE
org.killbill.billing.plugin.forte.secureTransactionKey=FFF
org.killbill.billing.plugin.forte.test=true' \
http://127.0.0.1:8080/1.0/kb/tenants/uploadPluginConfig/killbill-forte
```
Usage
-----
Add a payment method (Bank Of America checking account):
```
curl -v \
-u admin:password \
-H "X-Killbill-ApiKey: bob" \
-H "X-Killbill-ApiSecret: lazar" \
-H "Content-Type: application/json" \
-H "X-Killbill-CreatedBy: demo" \
-X POST \
--data-binary '{
"pluginName": "killbill-forte",
"pluginInfo": {
"properties": [
{
"key": "accountHolderName",
"value": "Bob Smith"
},
{
"key": "trn",
"value": "122400724"
},
{
"key": "accountNumber",
"value": "123456789"
},
{
"key": "accountType",
"value": "C"
}
]
}
}' \
"http://127.0.0.1:8080/1.0/kb/accounts//paymentMethods?isDefault=true"
```
Notes:
* Make sure to replace *ACCOUNT_ID* with the id of the Kill Bill account
To trigger a payment:
```
curl -v \
-u admin:password \
-H "X-Killbill-ApiKey: bob" \
-H "X-Killbill-ApiSecret: lazar" \
-H "Content-Type: application/json" \
-H "X-Killbill-CreatedBy: demo" \
-X POST \
--data-binary '{"transactionType":"PURCHASE","amount":"500","currency":"USD","transactionExternalKey":"INV-'$(uuidgen)'-PURCHASE"}' \
"http://127.0.0.1:8080/1.0/kb/accounts//payments"
```
Notes:
* Make sure to replace *ACCOUNT_ID* with the id of the Kill Bill account
You can verify the payment via:
```
curl -v \
-u admin:password \
-H "X-Killbill-ApiKey: bob" \
-H "X-Killbill-ApiSecret: lazar" \
"http://127.0.0.1:8080/1.0/kb/accounts//payments?withPluginInfo=true"
```
Notes:
* Make sure to replace *ACCOUNT_ID* with the id of the Kill Bill account