These docs are for v2.5. Click to read the latest docs for v3.0.

Single Payment Widget

Our Single Payment Widget can be embedded within a checkout journey to support Open Banking payments direct from UK bank accounts as an alternative to card payment solutions. It can support one or many end payees.

Create a Payment Widget

Create a new widget and select Single Payment Widget as the widget type. Start by filling out the general fields:

NameDescriptionRequirement
Widget NameUsed to identify the widget in Moneyhub admin portal only.Required
BusinessThe API Business the logged on user is linked to (one or many). API Business name is initially set by Moneyhub. You can create many different widgets under your API business.Required
Widget StatusCan be either Production or Sandbox. This dictates whether live banks or test banks are accessible during the payment flow.
Note: the status cannot be changed after creation, a new widget would need to be created.
Required
Authorised DomainsIf you choose to host the widget yourself, specify a list of domains on which it can be hosted. Optional

An example could look like:

A payment widget requires a payee account that will receive the money. You need to supply valid UK bank account details for the payment to be sent to.

NameDescriptionRequirement
Display NameCan differ from the actual bank account name to support aliasingOptional
Account NameUsed when instructing the paymentRequired
Account NumberValid UK bank account numberRequired
Sort CodeValid UK sort codeRequired

Furthermore, you need to specify the default payment details.

NameDescriptionRequirement
AmountA default amount that the end user is expected to pay.Required
ReferenceA payment reference can be specified, which will be the same for every payment, or it can be left blank to generate a unique reference code for each payment.Optional

An example could look like:

After a widget is created, the default values can be overwritten by passing in params during widget instantiation. These include:

NameDescription
payeeIdOnce a widget is created a unique Payee ID is associated to each payee created. You can change which payee the widget will use here.
amountThe payment amount in minor units
referenceFor example: invoice ID, vendor name
endToEndIdUnique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain.

📘

Preview Widget

Once a Widget has been created it can be Previewed via the top menu bar, see Preview

Example Payment Widget Journey

414 410 411 413 416

What’s Next