Payments

GOV.UK Pay Integration

Central Government is becoming smarter. It has recognised that there are common functions provided in local government and it makes sense for these to be commoditised to enable reuse across departments and across local government. To that end they've built dedicated functions to: 

  • Take payments
  • Issue notifications (email/SMS/letters)
  • Confirm someone's identity.

These are the PAY, NOTIFY, VERIFY, services respectively. In its Blue Badge platform, IEG4 has already integrated to both PAY and NOTIFY and our intention is to leverage these wherever logical and of benefits across its products.

 

So in this release, we've built in the no code ability to build an online form that fully integrates to GOV.UK PAY. For some perspective, I was able to add a payment integration to a form and test it for the first time in less than 5 minutes.

 

Setting GOV.UK PAY up

The only technical element to this process is to add your council's API reference key as provided by GOV.UK PAY. You access these within your GOV.UK PAY account. You can create an account here if your council has not already done so.

The settings within System Management you can update are as follows with the critical one being the GovPayBearerToken: 

 

Setting 

Default 

Information 

GovPayBaseUrl 

https://publicapi.payments.service.gov.uk/ 

This is the default URL for GOV.UK PAY integration. This can thus be changed if this URL does change. 

GovPayBearerToken 

blank 

This is the API key you get from your GOV.UK PAY account and is the only thing needed to be done by you in terms of set up of this function 

GovPayPaymentUrl 

v1/payments 

This is the default endpoint for where we should pass payment info. This can thus be changed if this URL does change. 

 

 

Important

The thing to also be aware of is that we need to set your payment preference to GOV.UK PAY. So if you wish to use this function please tell us at:

https://help.ieg4.com

 

You can only have one Payment provider for your form's integration. So if you currently integrate using Capita/Civica payment gateways you can change it to GOV.UK PAY but this will mean all forms will thus have that payment mechanism too.

 

Functionality

It's incredibly easy to add GOV.UK Pay integration to an online service once the above set up is done. It can also leverage the existing functionality dynamically change the amount to pay/sum a number of items and show them in a payment summary.

To illustrate we will build a form that allows people to sign up to a council's garden waste service. This takes a payment of  120.00 for the year.

So to start we've created a form:

 

blobid0.png

 

We then go to the designer menu and click 'Payment Settings':   

 

blobid1.png

 

The above is for the actual GOV.UK PAY Description. Then to associate a monetary value with an item or items we need to add a payment item to the form. This is done by first selecting the following when adding an item: 

 

blobid2.png

 

The following is presented and we add Garden Waste Services as a 'Purchasable item'. This is to relay the amount of money that should be passed into the payment summary: 

 

blobid3.png

 

We then add a question to allow the person to opt in to receiving the service: 

 

blobid4.png

 

And add conditional logic (using Page Rules) to only show/add the payment if they select 'Yes': 

 

blobid5.png

 

Once done, we now have a form that will capture their opt-in, conditionally show the amount to pay and integrate to GOV.UK PAY. This literally takes seconds to do and we can see the description we added showing in the GOV.UK PAY Payment Summary on the far right image: 

 

blobid6.png

 

Other Information 

  1. Whilst you can still use the built in payment summary (shopping basket) function to automatically calculate a total to pay, the GOV.UK Pay API currently only supports one description. I.e. if I paid for a Black bin (£40.00) and a Blue bin (£25.00) this would show the two items and a total of £65.00. But for GOV.UK PAY purposes it would need a generic description of Bin Payments or something.  
  2.  Apple Pay and Google Pay Digital Wallets are currently in Private Beta. I.e. only certain central government departments are using them right now. We will, however, be able to leverage this straight away when publicly available.