How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yapily Variable Recurring Payments API

Variable Recurring Payments enables transfer of money between accounts held by the same person or transfer of money for business payments. In order to make Sweeping Variable Recurring Payments on behalf of a user, you are required to request an [Consent](#tag/Authorisations) from the user by calling the Sweeping Consent endpoint to authorise the user's account to make the payment. Once a `consent-token` is obtained, you can call the Payments endpoint to execute the Sweeping Variable Recurring Payments transaction. Before executing the payment, you have the option to confirm availability of funds in the user's account by calling the Funds Confirmation endpoint. See [VRP Payments](/payments/vrps/additional-information) for more information.

Yapily Variable Recurring Payments API is one of 16 APIs that Yapily publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Variable Recurring Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 4 JSON Schemas.

This API exposes 5 operations across 5 paths, and defines 47 schemas. It is described by OpenAPI 3.2.0, at version 12.4.0.

Requests are made against a single base URL, https://api.yapily.com.

5 operations 5 paths 47 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
12.4.0
Base URL
https://api.yapily.com
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

Yapily Variable Recurring Payments API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the [Yapily Console](https://conso…

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Variable Recurring Payments 5

Variable Recurring Payments enables transfer of money between accounts held by the same person or transfer of money for business payments. In order to make Sweeping Variable Recur…

POST
/variable-recurring-payments/sweeping/consents
Create Sweeping Vrp Authorisation
createSweepingAuthorisation body → 201401default
GET
/variable-recurring-payments/sweeping/consents/{consentId}
Get Sweeping Vrp Consent Details
getSweepingVrpConsentById 1 param → 200401default
POST
/variable-recurring-payments/funds-confirmation
Confirm Funds for Vrp Payment
createVrpFundsConfirmation 1 param body → 201401default
POST
/variable-recurring-payments/payments
Create Vrp Payment
createVrpPayment 1 param body → 201401default
GET
/variable-recurring-payments/payments/{paymentId}/details
Get Vrp Payment Details
getVrpPaymentDetails 2 params → 200401default

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are VrpSweepingAuthorisationResponse (17 properties), VrpSubmissionResponse (13 properties), Address (10 properties), VrpSweepingAuthorisationRequest (10 properties). Each schema is shown below with its type and property counts.

ErrorIssue
object
Detailed information regarding the issue that was experienced during processing of the request
5 properties 2 required
Payer
object
Conditional. Details of the benefactor [person or business].
3 properties 1 required
VrpSubmissionRequest
object
Mandatory. The payment request object defining the details of the payment for execution under the Variable Recurring Payment consent.
3 properties 3 required
VrpFundsConfirmationRequest
object
2 properties 1 required
AccountIdentification
object
2 properties 2 required
RawResponse
object
[DEPRECATED] Interaction (raw request and response) that occurred with the Institution in order to fulfil a request.
5 properties
VrpUltimatePayer
object
4 properties
ApiErrorResponse
object
Used to return errors from the bank from each request - 400 - Returned by any POST endpoint when the body does not conform to the contract - 401 - Returned by…
1 property
RedirectRequest
object
Optional. The server to redirect the user to after the user complete the authorisation at the Institution.
1 property 1 required
FeatureEnum
string
Used to describe what functions are supported by the associated Institution. For more information on each feature, see the following links: - [Financial Data F…
PaymentStatus
string
The status of the Payment. For more information, see [Payment Status](/guides/payments/payment-status/)
VrpInitiationDetails
object
The definition of the payer and payee.
5 properties
VrpFundsConfirmationResponse
object
4 properties 2 required
ApiResponseOfVrpFundsConfirmationResponse
object
6 properties
VrpComplianceDataIndividual
object
Conditional. Mandatory if the type is INDIVIDUAL.
2 properties 2 required
RefundAccount
object
The account to which funds should be returned if the payment is to be later refunded.
2 properties
VrpSweepingAuthorisationResponse
object
17 properties
PaymentStatusDetails
object
6 properties
RawRequest
object
8 properties
VrpComplianceDataPayer
object
Conditional. Payer details required for compliance checks.
3 properties 1 required
VrpControlParameters
object
The definition of VRP parameters.
5 properties 3 required
VrpUltimatePayee
object
7 properties
ErrorDetails
object
6 properties 3 required
VrpSweepingRiskDetails
object
The details required by the institutions to detect and prevent fraud.
1 property
AccountIdentificationType
string
Mandatory. Used to describe the format of the account. See [Account Identification Combinations](/payments/payment-resources/intro-to-payment-executionaccount-…
ResponseMeta
object
1 property
Address
object
Conditional. The address of the Payee or Payer. - payee.address is mandatory when the paymentType is an INTERNATIONAL payment - An Institution may require you…
10 properties
MultiAuthorisation
object
Details the additional levels of authorisation which are required from, and being managed by, the Institution.
5 properties
VrpComplianceDataAddress
object
This is the registered company or trading address of your end user.
5 properties 4 required
Amount
object
Mandatory. Monetary Amount.
2 properties 2 required
VrpSubmissionResponse
object
13 properties 2 required
PaymentIsoStatusCodeEnum
string
The ISO 20022 PaymentStatusCode.
AuthorisationStatus
string
Current status of the embedded authorisation request in code form.
PayeeAccountType
string
Optional. The payee account type. Allowed values: BUSINESS, BUSINESSSAVING, CHARITY, COLLECTION, CORPORATE, EWALLET, GOVERNMENT, INVESTMENT, INVESTMENTISA, JOI…
VrpSweepingAuthorisationRequest
object
10 properties 3 required
ApiResponseOfVrpSubmissionResponse
object
6 properties
VrpSubmissionDetails
object
Mandatory. The payment submission object defining the details of the payment instruction to be executed under the Variable Recurring Payment.
3 properties 2 required
PaymentIsoStatus
object
The payment status code, as denoted by a 3-letter ISO 20022 code.
2 properties
Payee
object
Mandatory. Details of the beneficiary [person or business].
6 properties 2 required
VrpComplianceData
object
Conditional. Information needed to complete compliance checks. Mandatory for Yapily Connect customers.
1 property
AddressTypeEnum
string
Optional. The type of address
VrpPeriodicLimits
object
3 properties 3 required
ApiResponseOfVrpSweepingAuthorisationResponse
object
6 properties
VrpFundsAvailable
object
2 properties 2 required
InstitutionError
object
Raw error details provided by the Institution, when it was the error source.
2 properties
ResponseForwardedData
object
2 properties
VrpComplianceDataBusiness
object
Conditional. Mandatory if the type is BUSINESS.
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yapily-variable-recurring-payments-api-openapi.yml Raw ↑

Other APIs Yapily publishes across the network.

Yapily Institutions API
Yapily Consents and Authorisations API
Yapily Payments API (PIS)
Yapily Data Plus API
Yapily Application Beneficiaries API
Yapily Application Management API
Yapily Authorisations API
Yapily Constraints API
Yapily Financial Data API
Yapily Hosted Consent Pages API
Yapily Hosted Payment Pages API
Yapily Notifications API
Where this information came from

This is an independent, third-party profile of Yapily Variable Recurring Payments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.