GovukPayApiClient

A simple client to integrate with the Govuk Pay payment gateway.

Usage

Create Payment

GovukPayApiClient::CreatePayment.call(<fee object>, <url to return to>)

The first argument is a fee object that must repond to #description (text), #reference (string), and #amount (integer, in pence). The second object is a url string that tells the Gov UK Pay gateway where to redirect the user after a successful payment. Both are required.

GovukPayApiClient::RequiresFeeObject will be raised if a fee object is not supplied.

GovukPayApiClient::RequiresReturnUrl will be raised if a return url is not supplied.

Get Status

GovukPayApiClient::GetStatus.call(<fee object>)

Requires a fee object that must respond to #govpay_payment_id, which should return an id that is valid on the Gov UK Pay gateway.

It returns an object with the method #status for a successful calls. Unsuccessful calls raise errors in the 400 to 599 status range and will therefore raise GovukPayApiClient::Unavailable errors.

GovukPayApiClient::RequiresFeeObject will be raised if a fee object is not supplied.

Errors

If any GovukPayApiClient post or get request returns a status in the 400 to 599 range, the client will raise GovukPayApiClient::Unavailable. It will also raise GovukPayApiClient::Unavailable if the connection times out or is otherwise unavailable.

Examples

See the dummy Rails app in /spec/dummy for examples of how the gem might be used in a production environment.

Installation

Add this line to your application's Gemfile:

gem 'govuk-pay-api-client'

And then execute:

$ bundle

Or install it yourself as:

$ gem install govuk-pay-api-client

Testing

Run bundle rake in the gem source directory for a full set of specs, mutation tests and rubocop checks.

In an application

Examples of how this gem might be used can be found in the specs. There is also a set of RSpec shared examples that can be copied and modified. These can be found in spec/suppport/shared_examples_for_govpay.rb.

Contributing

Fork, then clone the repo:

git clone [email protected]:your-username/govuk-pay-api-client.git

Make sure the tests pass:

bundle
bundle db:setup
bundle exec rake

Make your change. Add specs for your change. Make the specs pass:

bundle exec rake

Push to your fork and submit a pull request.

Some things that will increase the chance that your pull request is accepted:

Write specs.
Make sure you don’t have any mutants (part of total test suite).
Write a good commit message.