From bdc7d26774e0335a49d7c321e9b603689f0f24b3 Mon Sep 17 00:00:00 2001 From: Stepan Stanc Date: Thu, 11 Jun 2026 16:01:37 +0200 Subject: [PATCH 1/3] FINTECH-18408: Remove reservation-based paymentPlans/add from docs The v1 reservation-based Add payment plan operation was hidden from the OpenAPI document (MewsSystems/mews#82259) in favor of billingAutomationPaymentPlans/add. Regenerated paymentplans.md from the production spec, removed the operation from the operations index, and added a changelog entry. Co-Authored-By: Claude Fable 5 --- connector-api/changelog/README.md | 8 +++ connector-api/operations/README.md | 1 - connector-api/operations/paymentplans.md | 91 +++--------------------- 3 files changed, 17 insertions(+), 83 deletions(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index 9718521b..b416bd05 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -3,6 +3,14 @@ {% updates format="full" %} {% update date="2026-06-11" %} +## Removed reservation-based Add payment plan from the documentation + +- Add payment plan (`paymentPlans/add`): + - **Removed** this restricted operation from the documentation. It is superseded by [Add billing automation payment plan](../operations/paymentplans.md#add-billing-automation-payment-plan). The operation remains functional for existing integrations, but new integrations should use billing automation payment plans instead. + +{% endupdate %} +{% update date="2026-06-11" %} + ## May 2026 updates - [Add availability blocks](../operations/availabilityblocks.md#add-availability-blocks): diff --git a/connector-api/operations/README.md b/connector-api/operations/README.md index b865be1e..4ec01984 100644 --- a/connector-api/operations/README.md +++ b/connector-api/operations/README.md @@ -144,7 +144,6 @@ This section describes all operations supported by the API, organised here by th | [Get all order items](orderitems.md#get-all-order-items) | Returns all order items | | [Cancel order items](orderitems.md#cancel-order-items) | **Restricted!** Cancels specified order items | | [Refund payment](payments.md#refund-payment) | Refunds a specified payment | -| [Add payment plan](paymentplans.md#add-payment-plan) | **Restricted!** Adds a payment plan connected to a `Reservation`; used for recurring payments | | [Add billing automation payment plan](paymentplans.md#add-billing-automation-payment-plan) | **Restricted!** Adds a payment plan connected to a billing automation | | [Get all ledger balances](ledgerbalances.md#get-all-ledger-balances) | Returns balances of specified ledgers for each day | diff --git a/connector-api/operations/paymentplans.md b/connector-api/operations/paymentplans.md index c1e553ce..41b27fa3 100644 --- a/connector-api/operations/paymentplans.md +++ b/connector-api/operations/paymentplans.md @@ -1,88 +1,6 @@ # Payment plans -## Add payment plan - -> ### Restricted! -> This operation is currently in beta-test and as such it is subject to change. - -Adds a payment plan connected to a `Reservation` and returns the payment request URL associated with the created payment plan. The fulfillment of the payment request will initiate the payment plan. -Note this operation supports [Portfolio Access Tokens](../concepts/multi-property.md). - -### Request - -`[PlatformAddress]/api/connector/v1/paymentPlans/add` - -```javascript -{ - "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", - "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", - "Client": "Sample Client 1.0.0", - "ReservationId": "0f515589-99b4-423d-b83a-b237009f0509", - "Name": "Payment Plan Name", - "PaymentRequest": { - "PaymentMethods": [ - "PaymentCard", - "SepaDirectDebit" - ], - "Message": "Payment request message", - "Note": "Internal Note", - "PaymentRequestType": "Payment", - "PaymentRequestExpirationOffsetDays": 30, - "SendEmail": false - }, - "StartMonth": "2023-10" -} -``` - -| Property | Type | Contract | Description | -| :-- | :-- | :-- | :-- | -| `ClientToken` | string | required | Token identifying the client application. | -| `AccessToken` | string | required | Access token of the client application. | -| `Client` | string | required | Name and version of the client application. | -| `EnterpriseId` | string | optional | Unique identifier of the enterprise. Required when using [Portfolio Access Tokens](../concepts/multi-property.md), ignored otherwise. | -| `ReservationId` | string | required | Reservation Id associated with the payment plan. | -| `Name` | string | required | Name of the payment plan. | -| `PaymentRequest` | [Payment plan payment request](paymentplans.md#payment-plan-payment-request) | required | Data related to the payment request associated with the payment plan created. | -| `StartMonth` | string | optional | Specifies the month when the payment plan begins collecting payments, in the 'YYYY-MM' format. The month must be in the future and fall within the reservation period. | - -#### Payment plan payment request - -| Property | Type | Contract | Description | -| :-- | :-- | :-- | :-- | -| `PaymentMethods` | array of [Available payment plan payment methods](paymentplans.md#available-payment-plan-payment-methods) | required | Allowed payment methods to pay for the payment plan. | -| `Message` | string | required | Message in the payment request. | -| `Note` | string | optional | Internal note for the payment request. | -| `PaymentRequestType` | [Payment plan payment request type](paymentplans.md#payment-plan-payment-request-type) | optional | Type of payment request to create. If not specified, defaults to `Payment`. | -| `PaymentRequestExpirationOffsetDays` | integer | optional | Custom expiration date offset in days for the payment request. If not set, it'll expire in one week, unless the first scheduled payment should be executed before. In that case, The expiration date will be set one second before the scheduled payment execution (the last possible moment when we can get the payment method). | -| `SendEmail` | boolean | optional | Specifies whether a payment request email is sent to the customer. Defaults to true. | - -#### Available payment plan payment methods - -* `Ideal` - iDEAL -* `PaymentCard` - Payment card -* `ApplePay` - Apple Pay -* `GooglePay` - Google Pay -* `SepaDirectDebit` - SEPA Direct Debit -* `All` - -#### Payment plan payment request type - -* `Payment` -* `PaymentMethod` - -### Response - -```javascript -{ - "PaymentRequestUrl": "https://example.com/payment-request-url" -} -``` - -| Property | Type | Contract | Description | -| :-- | :-- | :-- | :-- | -| `PaymentRequestUrl` | string | required | Payment request URL associated with the created payment plan. | - ## Add billing automation payment plan > ### Restricted! @@ -141,6 +59,15 @@ Note this operation supports [Portfolio Access Tokens](../concepts/multi-propert | `ExpirationDateUtc` | string | required | Expiration date (UTC time) of the payment request. Must be within 30 days of payment plan creation. ISO-8601 format. | | `SendEmail` | boolean | required | Specifies whether a payment request email is sent to the customer. | +#### Available payment plan payment methods + +* `Ideal` - iDEAL +* `PaymentCard` - Payment card +* `ApplePay` - Apple Pay +* `GooglePay` - Google Pay +* `SepaDirectDebit` - SEPA Direct Debit +* `All` + ### Response ```javascript From ccea3e96412516b059c76c99a6948e79de2ec90e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=A0t=C4=9Bp=C3=A1n=20=C5=A0tanc?= Date: Fri, 12 Jun 2026 13:49:56 +0200 Subject: [PATCH 2/3] Apply suggestion from @jnv Co-authored-by: Jan Vlnas --- connector-api/changelog/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index b416bd05..0367bb30 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -5,7 +5,7 @@ ## Removed reservation-based Add payment plan from the documentation -- Add payment plan (`paymentPlans/add`): +- Add payment plan: - **Removed** this restricted operation from the documentation. It is superseded by [Add billing automation payment plan](../operations/paymentplans.md#add-billing-automation-payment-plan). The operation remains functional for existing integrations, but new integrations should use billing automation payment plans instead. {% endupdate %} From e4ac8c60c1653ceac36453139ad3dc7dbe9c9f32 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=A0t=C4=9Bp=C3=A1n=20=C5=A0tanc?= Date: Fri, 12 Jun 2026 13:50:32 +0200 Subject: [PATCH 3/3] Apply suggestion from @jnv Co-authored-by: Jan Vlnas --- connector-api/changelog/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index 0367bb30..98cced33 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -6,7 +6,7 @@ ## Removed reservation-based Add payment plan from the documentation - Add payment plan: - - **Removed** this restricted operation from the documentation. It is superseded by [Add billing automation payment plan](../operations/paymentplans.md#add-billing-automation-payment-plan). The operation remains functional for existing integrations, but new integrations should use billing automation payment plans instead. + - **Removed** restricted operation from the documentation. It is superseded by [Add billing automation payment plan](../operations/paymentplans.md#add-billing-automation-payment-plan). {% endupdate %} {% update date="2026-06-11" %}