Changes from gocardless/client-library-templates

src/main/java/com/gocardless/services/PayerAuthorisationService.java

@@ -73,7 +73,13 @@ public PayerAuthorisationService(HttpClient httpClient) {
     /**
      * Retrieves the details of a single existing Payer Authorisation. It can be used for polling
      * the status of a Payer Authorisation.
+     *
+     * @deprecated Payer Authorisation is legacy API and cannot be used by new integrators. The
+     *             Billing Request
+     *             (https://developer.gocardless.com/api-reference/#billing-requests) API should be
+     *             used for any new integrations.
      */
+    @Deprecated
     public PayerAuthorisationGetRequest get(String identity) {
         return new PayerAuthorisationGetRequest(httpClient, identity);
     }
@@ -84,7 +90,13 @@ public PayerAuthorisationGetRequest get(String identity) {
      * used for the other actions. This endpoint has been designed this way so you do not need to
      * save any payer data on your servers or the browser while still being able to implement a
      * progressive solution, such as a multi-step form.
+     *
+     * @deprecated Payer Authorisation is legacy API and cannot be used by new integrators. The
+     *             Billing Request
+     *             (https://developer.gocardless.com/api-reference/#billing-requests) API should be
+     *             used for any new integrations.
      */
+    @Deprecated
     public PayerAuthorisationCreateRequest create() {
         return new PayerAuthorisationCreateRequest(httpClient);
     }
@@ -99,7 +111,13 @@ public PayerAuthorisationCreateRequest create() {
      * Note that in order to update the <code>metadata</code> attribute values it must be sent
      * completely as it overrides the previously existing values.
      * </p>
+     *
+     * @deprecated Payer Authorisation is legacy API and cannot be used by new integrators. The
+     *             Billing Request
+     *             (https://developer.gocardless.com/api-reference/#billing-requests) API should be
+     *             used for any new integrations.
      */
+    @Deprecated
     public PayerAuthorisationUpdateRequest update(String identity) {
         return new PayerAuthorisationUpdateRequest(httpClient, identity);
     }
@@ -109,7 +127,13 @@ public PayerAuthorisationUpdateRequest update(String identity) {
      * time, a 200 HTTP status is returned if the resource is valid and a 422 error response in case
      * of validation errors. After it is successfully submitted, the Payer Authorisation can no
      * longer be edited.
+     *
+     * @deprecated Payer Authorisation is legacy API and cannot be used by new integrators. The
+     *             Billing Request
+     *             (https://developer.gocardless.com/api-reference/#billing-requests) API should be
+     *             used for any new integrations.
      */
+    @Deprecated
     public PayerAuthorisationSubmitRequest submit(String identity) {
         return new PayerAuthorisationSubmitRequest(httpClient, identity);
     }
@@ -124,7 +148,13 @@ public PayerAuthorisationSubmitRequest submit(String identity) {
      * through our flow or make them go through the necessary verification mechanism (upcoming
      * feature).
      * </p>
+     *
+     * @deprecated Payer Authorisation is legacy API and cannot be used by new integrators. The
+     *             Billing Request
+     *             (https://developer.gocardless.com/api-reference/#billing-requests) API should be
+     *             used for any new integrations.
      */
+    @Deprecated
     public PayerAuthorisationConfirmRequest confirm(String identity) {
         return new PayerAuthorisationConfirmRequest(httpClient, identity);
     }

src/main/java/com/gocardless/services/RedirectFlowService.java

@@ -68,14 +68,24 @@ public RedirectFlowService(HttpClient httpClient) {
     /**
      * Creates a redirect flow object which can then be used to redirect your customer to the
      * GoCardless hosted payment pages.
+     *
+     * @deprecated Redirect Flows are legacy APIs and cannot be used by new integrators. The Billing
+     *             Request flow (https://developer.gocardless.com/api-reference/#billing-requests)
+     *             API should be used for your payment flows.
      */
+    @Deprecated
     public RedirectFlowCreateRequest create() {
         return new RedirectFlowCreateRequest(httpClient);
     }
 
     /**
      * Returns all details about a single redirect flow
+     *
+     * @deprecated Redirect Flows are legacy APIs and cannot be used by new integrators. The Billing
+     *             Request flow (https://developer.gocardless.com/api-reference/#billing-requests)
+     *             API should be used for your payment flows.
      */
+    @Deprecated
     public RedirectFlowGetRequest get(String identity) {
         return new RedirectFlowGetRequest(httpClient, identity);
     }
@@ -94,7 +104,12 @@ public RedirectFlowGetRequest get(String identity) {
      * if your integration has already completed this flow. It will return a
      * <code>bad_request</code> error if the <code>session_token</code> differs to the one supplied
      * when the redirect flow was created.
+     *
+     * @deprecated Redirect Flows are legacy APIs and cannot be used by new integrators. The Billing
+     *             Request flow (https://developer.gocardless.com/api-reference/#billing-requests)
+     *             API should be used for your payment flows.
      */
+    @Deprecated
     public RedirectFlowCompleteRequest complete(String identity) {
         return new RedirectFlowCompleteRequest(httpClient, identity);
     }