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 Hosted Payment Pages API

Hosted Payment Pages endpoints for payments products

Yapily Hosted Payment Pages 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 Hosted Payment Pages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 4 JSON Schemas.

This API exposes 10 operations across 9 paths, and defines 73 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.

10 operations 9 paths 73 schemas 4 GET6 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 Hosted Payment Pages 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 10

Across 9 paths, the API surfaces 10 operations — 4 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Hosted Payment Pages 10

Hosted Payment Pages endpoints for payments products

POST
/hosted/payment-requests
Create Hosted Payment Request
createHostedPaymentRequest 1 param body → 201400401500default
POST
/hosted/payment-requests/links
Create Pay by Link
createHostedPaymentRequestLink body → 201400401500default
GET
/hosted/payment-requests/{paymentRequestId}
Get Hosted Payment Request
getHostedPaymentRequest 2 params → 200401404500default
POST
/hosted/vrp/consent-requests
Create Vrp Consent
createHostedVRPConsentRequest 1 param body → 201400401500
GET
/hosted/vrp/consent-requests
Get Hosted Vrp Consent Requests
getHostedVRPConsentRequests 1 param → 200400401500
GET
/hosted/vrp/consent-requests/{consentRequestId}
Get Hosted Vrp Consent Request
getHostedVrpConsentRequest 2 params → 200401404500
POST
/hosted/vrp/consent-requests/{consentRequestId}/revoke
Revoke Hosted Vrp Consent Request
revokeHostedConsentRequest 2 params → 200401404500
POST
/hosted/vrp/consent-requests/{consentRequestId}/payments
Create Vrp Payment
createHostedVrpPayment 3 params body → 201401default
GET
/hosted/vrp/consent-requests/{consentRequestId}/payments/{paymentId}
Get Vrp Payment
getHostedVRPPaymentRequest 3 params → 200401404500
POST
/hosted/vrp/consent-requests/{consentRequestId}/funds-confirmation
Check Funds Availability
createHostedVrpFundsConfirmation 3 params body → 201401default

Schemas 73

The contract defines 73 schemas that model the data the API accepts and returns. The most detailed are HostedPayment (16 properties), HostedVRPConsentDetails (13 properties), HostedVRPPaymentResponse (13 properties), HostedPaymentDetails (12 properties). Each schema is shown below with its type and property counts.

Payer
object
Conditional. Details of the benefactor [person or business].
3 properties 1 required
UserSettings
object
Specifies the language and location preferences of the user.
2 properties
VrpFundsConfirmationRequest
object
2 properties 1 required
HostedNonSweepingPeriodicLimits
object
3 properties 3 required
ApiResponseOfRevokeHostedVRPConsentRequest
object
2 properties
PayeeDetailsResponse
object
Details of the beneficiary [person or business].
5 properties
HostedVRPConsentRequestResponse
object
12 properties 5 required
HostedVrpRefundAccount
object
The account to which funds should be returned if the payment is to be later refunded.
2 properties
ApiResponseOfGetHostedPaymentRequest
object
2 properties
CreateHostedPaymentRequest
object
6 properties 3 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
InstitutionIdentifiersResponse
object
Specifies the institution selected for making the payment.
2 properties
CreateHostedVRPPaymentRequest
object
Mandatory. The payment request object defining the details of the payment for execution under the Variable Recurring Payment consent.
2 properties 2 required
ApiResponseOfGetHostedVRPConsentRequest
object
2 properties
InstitutionIdentifiers
object
Specifies the institution requirements for making the payment. Skips the bank selection screen in payment flow if the institutionId and institutionCountryCode…
2 properties 1 required
GetHostedVRPConsentsResponse
array
HostedPaymentDetails
object
12 properties
ApiResponseOfCreateHostedVRPPaymentRequest
object
3 properties
PaymentStatus
string
The status of the Payment. For more information, see [Payment Status](/guides/payments/payment-status/)
AddressTypeEnumResponse
string
The type of address
HostedPaymentPhase
object
The phase of the payment.
2 properties
AddressResponse
object
The address of the Payee or Payer.
10 properties
ApiResponseOfGetHostedVRPConsentsRequest
object
2 properties
VrpFundsConfirmationResponse
object
4 properties 2 required
ApiResponseOfCreateHostedPaymentRequest
object
2 properties
AccountIdentificationTypeResponse
string
Used to describe the format of the account. See [Account Identification Combinations](/payments/payment-resources/intro-to-payment-executionaccount-identificat…
AccountIdentificationResponse
object
2 properties
HostedVRPLimitsRequest
object
The restrictions and limits for payments executed under the VRP consent
4 properties
ApiResponseOfVrpFundsConfirmationResponse
object
6 properties
ApiResponseOfCreateHostedVRPConsentRequest
object
2 properties
VRPSetup
object
9 properties 1 required
RawRequest
object
8 properties
ApiResponseOfCreateHostedPaymentRequestLink
object
2 properties
PaymentRisk
object
Additional information about the payment that may be used for risk scoring
1 property
CreateHostedVRPConsentRequest
object
7 properties 3 required
HostedPaymentIsoStatus
object
The ISO status of the payment.
2 properties
HostedPaymentRequestResponse
object
12 properties
HostedPaymentResponseDetails
object
Details of the payment.
8 properties
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
HostedPaymentRequestDetails
object
Details of the payment.
8 properties 4 required
PaymentTypeResponse
string
Specifies which of the [payment types](/payments/payment-resources/intro-to-payment-executionpayment-types) to execute.
HostedAmountDetails
object
The payment amount and currency
2 properties 2 required
AmountDetailsResponse
object
Monetary Amount.
2 properties
HostedVrpPayerResponse
object
Conditional. Details of the benefactor [person or business].
3 properties 1 required
ApiResponseError
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…
2 properties
ApiError
object
Provides details of the error that has occurred.
6 properties
Amount
object
Mandatory. Monetary Amount.
2 properties 2 required
HostedPaymentRequestDetailsLink
object
7 properties
PaymentContextTypeResponse
string
The payment context code.
HostedVRPConsentDetails
object
13 properties 4 required
HostedVRPPhase
object
The phase of the VRP Consent Request.
2 properties
PayeeAccountType
string
Optional. The payee account type. Allowed values: BUSINESS, BUSINESSSAVING, CHARITY, COLLECTION, CORPORATE, EWALLET, GOVERNMENT, INVESTMENT, INVESTMENTISA, JOI…
PaymentContextTypeV2
string
Optional. The payment context code. Allowed values are [BILLINADVANCE, BILLINARREARS, ECOMMERCEMERCHANT, FACETOFACEPOS, TRANSFERTOSELF,TRANSFERTOTHIRDPARTY, PI…
HostedVRPPaymentResponse
object
13 properties
Payee
object
Mandatory. Details of the beneficiary [person or business].
6 properties 2 required
PayerDetailsResponse
object
Details of the benefactor [person or business].
3 properties
PaymentType
string
Mandatory. Used to specify which of the [payment types](/payments/payment-resources/intro-to-payment-executionpayment-types) to execute. See [European Payments…
HostedVrpAccountIdentificationType
string
Used to describe the format of the account. Allowed values: MASKEDACCOUNTNUMBER SORTCODE ACCOUNTNUMBER
AddressTypeEnum
string
Optional. The type of address
HostedVrpAccountIdentification
object
2 properties 2 required
CreateHostedPaymentRequestLink
object
7 properties 3 required
ResponseForwardedData
object
2 properties
PaymentContextType
string
Optional. The payment context code. This defaults to OTHER if not specified.
HostedVRPLimits
object
The restrictions and limits for payments executed under the VRP consent
5 properties
VrpFundsAvailable
object
2 properties 2 required
InstitutionError
object
Raw error details provided by the Institution, when it was the error source.
2 properties
HostedPayment
object
16 properties
ApiResponseOfGetHostedVRPPaymentRequest
object
3 properties
VRPSetupRequest
object
9 properties 1 required
HostedPaymentStatusDetails
object
The status of the payment.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yapily-hosted-payment-pages-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 Notifications API
Yapily User Beneficiaries API
Where this information came from

This is an independent, third-party profile of Yapily Hosted Payment Pages 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.