Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yapily.com/llms.txt

Use this file to discover all available pages before exploring further.

Commercial VRP (cVRP) is available as a Private Beta version. Please contact your Customer Success Manager if you would like to access it.

Scope

There are two types of VRP available through Yapily, each with their own scope and restrictions.
Sweeping VRP is mandated by the CMA Order and is limited to sweeping services.
Sweeping VRP is subject to the following restrictions:
  • The payments must be between two accounts held by the same person or business
  • The payments must be domestic to the UK and deal in GBP
  • The source account must be a current account
  • Sweeping between current account providers, including to move funds between current accounts to avoid falling into overdraft on another current account
  • Sweeping to destination accounts which are used for unbundling overdrafts from a current account and other alternative forms of credit that closely compete with overdrafts
  • Sweeping to destination accounts which are used for loan repayments as part of a service that provides alternative forms of credit to an overdraft
  • Sweeping to a credit card account
  • Sweeping to cash savings accounts that are capable of paying interest
  • E-money accounts that are used by consumers and SMEs as substitutes for current accounts alternatives to savings accounts
  • Sweeping to make e-commerce purchases (including sweeping money to an e-money “me-to-me-to-business” account, in order to purchase goods or pay for services or pay for utility bills)
  • Sweeping to destination accounts used for the purchase of cryptocurrency
  • Sweeping in order to use online gambling and gaming services.
  • Sweeping to destination accounts used for foreign exchange or international money transfer services.
  • Investment products (including pensions) that may be used by consumers as alternatives to savings accounts

Institution Specifics

Some institutions impose limitations on the VRP flow or have non-standard capabilities. All known cases are detailed in this section.
InstitutionIDNotes
Monzomonzo_obThe period alignment for payment limits (periodicLimits.alignment) can be of type CONSENT only.

Compliance Requirements

VRPs are considered to be an ongoing relationship with the end user, meaning there are extra Know Your Customer (KYC) and transaction monitoring obligations on Yapily Connect Ltd. As a result, Yapily Connect customers using Yapily Connect’s PIS license for VRPs are required to provide extra fields about the end user who is making the payment. These details must be placed under the complianceData object when authorising a VRP payment. Refer to the endpoint’s API specification for details, and note that the required details will vary between a consumer and a business payer.
Customers with their own PISP license don’t need to provide these extra fields.
If you don’t provide the complianceData object in the request, you will receive an error and the request will not be processed.

Additional requirements for Commercial VRP

For cVRP, there are additional technical fields required beyond the standard complianceData object. These must be provided when initiating cVRP payments.
  • Transaction Risk Indicators (TRIs): TRIs are mandatory data fields attached to each cVRP payment initiation that help banks assess transaction risk. These are provided within the complianceData object. Key TRI fields include Payment Purpose Code, Payment Context Code, Contract Present Indicator, Beneficiary Pre-Populated, Beneficiary Account Type, and Merchant Category Code.
  • Ultimate Creditor: Where the ultimate recipient of funds is different from the named Creditor (for example, where a collections account is used), the UltimateCreditor field must be provided.
  • PSU Interaction Type: The PSUInteractionType field must be provided in both the consent and payment message, indicating whether the payer is present or the payment is biller-initiated.
  • Out-of-scope use case monitoring: You must only use cVRP for approved In-Scope Use Cases. If you become aware of any out-of-scope activity, notify Yapily immediately.
Refer to the endpoint’s API specification for the full list of required fields within the complianceData object for cVRP.