Proxypay

A ruby gem created by SmartTechys for the ProxyPay API by TimeBoxed that allows online payments using Angolan ATM's reference (Multicaixa references).

Installation

Add this line to your application's Gemfile:

gem 'proxypay'

And then execute:

$ bundle

Or install it yourself as:

$ gem install proxypay

Setup

Make sure you setup the environment variables PROXYPAY_USER and PROXYPAY_API_KEY:

PROXYPAY_USER=api
PROXYPAY_API_KEY=your_api_key_obtained_from_proxypay_folks

Usage

Use the class methods to get it going

References

Fetch all available references

Proxypay.get_references

Fetch references by using query's

or you can pass one or several query's parameters and even use the custom_fields defined at proxypay.

options = {status:"paid", offset:15, limit:13, q:{custom_fields:{your_fild:"some_data", some_other_filed:{that_takes:"an_hash"}}}}
Proxypay.get_reference(options)

Request a new reference - amount and expiration_date for the reference are mandatory

Proxypay.new_reference("2000.00", "2015-10-10")

Request a reference and add custom fields to your reference for your identification.

other_data = {invoice:"001-2015", description:"Client #{client_number} - monthly payment"}
Proxypay.new_reference("2000.00", "2015-10-10", other_data)

Request a reference and add custom fields to your reference for your identification on using a specific API_KEY

other_data = {invoice:"001-2015", description:"Client #{client_number} - monthly payment"}
api_key = "OcSLBANU4tjRi9gfW5VUcMqkvzLOcSLBANU4tjRi9gfW5VUcMqkvzL"
Proxypay.other_new_reference("2000.00", "2015-10-10", other_data, api_key)

Payments

Fetch all payments that haven't been acknowledged

Proxypay.get_payments

Fetch all the payments with limitation by the specified number(quantity)

options = {n:48}
Proxypay.get_payments(options)

Fetch all payments that haven't been acknowledged for an specific API KEY

api_key = "OcSLBANU4tjRi9gfW5VUcMqkvzLOcSLBANU4tjRi9gfW5VUcMqkvzL"
Proxypay.other_get_payments(api_key)

Fetch a specific payment by passing his ID

Proxypay.get_payment("OcSLBANU4tjRi9gfW5VUcMqkvzL")

Acknowledge a payment by passing his ID

Proxypay.new_payment("OcSLBANU4tjRi9gfW5VUcMqkvzL")

Acknowledge a payment by passing his ID for an specific API KEY

api_key = "OcSLBANU4tjRi9gfW5VUcMqkvzLOcSLBANU4tjRi9gfW5VUcMqkvzL"
Proxypay.other_new_payment("OcSLBANU4tjRi9gfW5VUcMqkvzL", api_key)

Acknowledge multiple payments by passing and array of ID's

ids = ["OcSLBANU4tjRi9gfW5VUcMqkvzL", "EcJLBANU4trUi8gfM6MOcMqkvzH","VxELBANU4tjRi9gfW5VUcMqkvzZ"]
Proxypay.new_payments(ids)

Help and Docs

• ProxyPay API
• RDOC

Development

• You can fork the project
• bundle
• bundle rake exec
• Make your feature addition or fix a bug
• Do not mess with rakefile, version or history (do not submit version bump PLEASE or put it in a different commit so we can ignore it when pull)
• Send us the pull request

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/smaziano/proxypay. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.