Attributes

• METHOD TYPEBank Transfer
• PAYMENTS
• PAYOUTS
• REFUNDS
• RECURRING

Introduction

Faster Payments is a banking initiative in the United Kingdom that enables near-instantaneous money transfers, reducing payment times between different banks’ customer accounts. If the receiving bank or building society also uses Faster Payments, payments arrive almost immediately (although sometimes it can take up to two hours).

Supported Countries

• UK

Supported Currencies

• GBP

Payout (Withdrawal) Flow

Follow these steps to perform a payout:

1. Register a userTokenId

A userTokenId is a field in the Nuvei system containing the user’s identifier in the merchant system.

If you do not have a userTokenId registered in the Nuvei system for this user, then register one by sending a /createUser request, including email, countryCode, firstName, and lastName.

In addition, the following parameters are mandatory to minimize transactions held by the RFI process:

• dateOfBirth
• address (for example: 1 Hardwick Street)
• city
• zip

Example /createUser Request

{
  "merchantId":"<your merchantId>",
  "merchantSiteId":"<your merchantSiteId>",
  "clientRequestId":"<unique request ID in merchant system>",
  "userTokenId":"<unique user identifier in merchant system>",
  "countryCode":"GB",
  "email":"[email protected]",
  "firstName":"John",
  "lastName":"Smith",
  "dateOfBirth":"2000-06-30",
  "address":"1 Hardwick Street",
  "city":"London",
  "zip":"EC1R"
  "timeStamp":"<YYYYMMDDHHmmss>",
  "checksum":"<calculated checksum>"
}

The request registers the userTokenId in the Nuvei system, which is then used to generate a UPO in the next step

Example /createUser Response

{
  "userId":78403498,
  "internalRequestId":552360538,
  "status":"SUCCESS",
  "errCode":0,
  "reason":"",
  "merchantId":"2439523627382132721",
  "merchantSiteId":"224428",
  "version":"1.0",
  "clientRequestId":"20221108130736"
}

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notification, which Nuvei recommends including in the /createUser request.

2. Create the UPO

Create a UPO by sending an /addUPOAPM request and include:

• userTokenId – The unique user identifier in your system.
• paymentMethodName: “apmgw_Faster_Payments“
• apmData class containing:
  • fasterPayments_iban

OR

• • fasterPayments_account_number
fasterPayments_sort_code
• billingAddress class containing: country and email

Example /addUPOAPM Request

{
  "merchantId":"<your merchantId>",
  "merchantSiteId":"<your merchantSiteId>",
  "userTokenId":"<unique customer identifier in merchant system>",
  "clientRequestId":"<unique request ID in merchant system>",
  "paymentMethodName":"apmgw_Faster_Payments",
  "apmData":{
    "fasterPayments_iban":"GB10CLRB04066800015427"
  },
  "billingAddress":{
    "country":"GB",
    "email":"[email protected]",
  },
  "timeStamp":"<YYYYMMDDHHmmss>",
  "checksum":"<calculated checksum>"
}

The request returns an encrypted userPaymentOptionId (UPO) representing the user’s APM account details.

Example /addUPOAPM Response

{
  "reason":"",
  "merchantId":"2502136204546424962",
  "errCode":0,
  "clientRequestId":"HWMTWQ2RT",
  "userPaymentOptionId":8119601,
  "internalRequestId":17817221,
  "version":"1.0",
  "status":"SUCCESS",
  "merchantSiteId":"126006"
}

3. Send a /payout Request

Send a /payout request and include the userPaymentOptionId, which contains the user’s previously stored APM account details. Press here for an example.

After the transaction is processed, Nuvei sends a DMN that includes the result of the transaction to the URL provided in urlDetails.notification, which Nuvei recommends including in the /payout request.

User Experience – Withdrawal

1. On the ‘Payment Details’ screen, the user selects ‘Bank Account’ or ‘IBAN’.
2. The user enters the details for the selection.
   A withdrawal request is created and processed.