adyen-ruby-api-library 11.2.0 → 12.0.0

data/lib/adyen/services/management/users_merchant_level_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Create a new user
     def create_new_user(request, merchant_id, headers: {})
-      endpoint = '/merchants/{merchantId}/users'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/users', merchant_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Get user details
     def get_user_details(merchant_id, user_id, headers: {})
-      endpoint = '/merchants/{merchantId}/users/{userId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, user_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/users/{userId}', merchant_id, user_id)
       
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Get a list of users
     def list_users(merchant_id, headers: {}, query_params: {})
-      endpoint = '/merchants/{merchantId}/users'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/users', merchant_id)
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Update a user
     def update_user(request, merchant_id, user_id, headers: {})
-      endpoint = '/merchants/{merchantId}/users/{userId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, user_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/users/{userId}', merchant_id, user_id)
       
       action = { method: 'patch', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/management/webhooks_company_level_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Generate an HMAC key
     def generate_hmac_key(company_id, webhook_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks/{webhookId}/generateHmac'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id, webhook_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks/{webhookId}/generateHmac', company_id, webhook_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Get a webhook
     def get_webhook(company_id, webhook_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id, webhook_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks/{webhookId}', company_id, webhook_id)
       
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # List all webhooks
     def list_all_webhooks(company_id, headers: {}, query_params: {})
-      endpoint = '/companies/{companyId}/webhooks'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks', company_id)
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Remove a webhook
     def remove_webhook(company_id, webhook_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id, webhook_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks/{webhookId}', company_id, webhook_id)
       
       action = { method: 'delete', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Set up a webhook
     def set_up_webhook(request, company_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks', company_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -64,9 +54,7 @@ module Adyen
 
     # Test a webhook
     def test_webhook(request, company_id, webhook_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks/{webhookId}/test'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id, webhook_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks/{webhookId}/test', company_id, webhook_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -74,9 +62,7 @@ module Adyen
 
     # Update a webhook
     def update_webhook(request, company_id, webhook_id, headers: {})
-      endpoint = '/companies/{companyId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, company_id, webhook_id)
+      endpoint = build_endpoint('/companies/{companyId}/webhooks/{webhookId}', company_id, webhook_id)
       
       action = { method: 'patch', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/management/webhooks_merchant_level_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Generate an HMAC key
     def generate_hmac_key(merchant_id, webhook_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks/{webhookId}/generateHmac'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, webhook_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks/{webhookId}/generateHmac', merchant_id, webhook_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Get a webhook
     def get_webhook(merchant_id, webhook_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, webhook_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks/{webhookId}', merchant_id, webhook_id)
       
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # List all webhooks
     def list_all_webhooks(merchant_id, headers: {}, query_params: {})
-      endpoint = '/merchants/{merchantId}/webhooks'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks', merchant_id)
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Remove a webhook
     def remove_webhook(merchant_id, webhook_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, webhook_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks/{webhookId}', merchant_id, webhook_id)
       
       action = { method: 'delete', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Set up a webhook
     def set_up_webhook(request, merchant_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks', merchant_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -64,9 +54,7 @@ module Adyen
 
     # Test a webhook
     def test_webhook(request, merchant_id, webhook_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks/{webhookId}/test'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, webhook_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks/{webhookId}/test', merchant_id, webhook_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -74,9 +62,7 @@ module Adyen
 
     # Update a webhook
     def update_webhook(request, merchant_id, webhook_id, headers: {})
-      endpoint = '/merchants/{merchantId}/webhooks/{webhookId}'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, webhook_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/webhooks/{webhookId}', merchant_id, webhook_id)
       
       action = { method: 'patch', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/management.rb

@@ -10,6 +10,7 @@ require_relative 'management/allowed_origins_merchant_level_api'
 require_relative 'management/android_files_company_level_api'
 require_relative 'management/client_key_company_level_api'
 require_relative 'management/client_key_merchant_level_api'
+require_relative 'management/donation_campaigns_api'
 require_relative 'management/my_api_credential_api'
 require_relative 'management/payment_methods_merchant_level_api'
 require_relative 'management/payout_settings_merchant_level_api'
@@ -92,6 +93,10 @@ module Adyen
       @client_key_merchant_level_api ||= Adyen::ClientKeyMerchantLevelApi.new(@client, @version)
     end
 
+    def donation_campaigns_api
+      @donation_campaigns_api ||= Adyen::DonationCampaignsApi.new(@client, @version)
+    end
+
     def my_api_credential_api
       @my_api_credential_api ||= Adyen::MyAPICredentialApi.new(@client, @version)
     end

data/lib/adyen/services/payment/modifications_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Change the authorised amount
     def adjust_authorisation(request, headers: {})
-      endpoint = '/adjustAuthorisation'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/adjustAuthorisation')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Cancel an authorisation
     def cancel(request, headers: {})
-      endpoint = '/cancel'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/cancel')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Cancel or refund a payment
     def cancel_or_refund(request, headers: {})
-      endpoint = '/cancelOrRefund'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/cancelOrRefund')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Capture an authorisation
     def capture(request, headers: {})
-      endpoint = '/capture'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/capture')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -55,10 +47,10 @@ module Adyen
     # Create a donation
     #
     # Deprecated 
+    # @deprecated
     def donate(request, headers: {})
-      endpoint = '/donate'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      Adyen::Deprecation.warn(:donate)
+      endpoint = build_endpoint('/donate')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -66,9 +58,7 @@ module Adyen
 
     # Refund a captured payment
     def refund(request, headers: {})
-      endpoint = '/refund'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/refund')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -76,9 +66,7 @@ module Adyen
 
     # Cancel an authorisation using your reference
     def technical_cancel(request, headers: {})
-      endpoint = '/technicalCancel'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/technicalCancel')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -86,9 +74,7 @@ module Adyen
 
     # Cancel an in-person refund
     def void_pending_refund(request, headers: {})
-      endpoint = '/voidPendingRefund'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/voidPendingRefund')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/payment/payments_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Create an authorisation
     def authorise(request, headers: {})
-      endpoint = '/authorise'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/authorise')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Complete a 3DS authorisation
     def authorise3d(request, headers: {})
-      endpoint = '/authorise3d'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/authorise3d')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Complete a 3DS2 authorisation
     def authorise3ds2(request, headers: {})
-      endpoint = '/authorise3ds2'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/authorise3ds2')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Get the 3DS authentication result
     def get_authentication_result(request, headers: {})
-      endpoint = '/getAuthenticationResult'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/getAuthenticationResult')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Get the 3DS2 authentication result
     def retrieve3ds2_result(request, headers: {})
-      endpoint = '/retrieve3ds2Result'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/retrieve3ds2Result')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/paymentsApp/payments_app_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Create a boarding token - merchant level
     def generate_payments_app_boarding_token_for_merchant(request, merchant_id, headers: {})
-      endpoint = '/merchants/{merchantId}/generatePaymentsAppBoardingToken'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/generatePaymentsAppBoardingToken', merchant_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Create a boarding token - store level
     def generate_payments_app_boarding_token_for_store(request, merchant_id, store_id, headers: {})
-      endpoint = '/merchants/{merchantId}/stores/{storeId}/generatePaymentsAppBoardingToken'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, store_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/stores/{storeId}/generatePaymentsAppBoardingToken', merchant_id, store_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Get a list of Payments Apps - merchant level
     def list_payments_app_for_merchant(merchant_id, headers: {}, query_params: {})
-      endpoint = '/merchants/{merchantId}/paymentsApps'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/paymentsApps', merchant_id)
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -44,9 +38,7 @@ module Adyen
 
     # Get a list of Payments Apps - store level
     def list_payments_app_for_store(merchant_id, store_id, headers: {}, query_params: {})
-      endpoint = '/merchants/{merchantId}/stores/{storeId}/paymentsApps'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, store_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/stores/{storeId}/paymentsApps', merchant_id, store_id)
       endpoint += create_query_string(query_params)
       action = { method: 'get', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)
@@ -54,9 +46,7 @@ module Adyen
 
     # Revoke Payments App instance authentication
     def revoke_payments_app(merchant_id, installation_id, headers: {})
-      endpoint = '/merchants/{merchantId}/paymentsApps/{installationId}/revoke'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint, merchant_id, installation_id)
+      endpoint = build_endpoint('/merchants/{merchantId}/paymentsApps/{installationId}/revoke', merchant_id, installation_id)
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, {}, headers, @version)

data/lib/adyen/services/payout/initialization_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Store payout details
     def store_detail(request, headers: {})
-      endpoint = '/storeDetail'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/storeDetail')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Store details and submit a payout
     def store_detail_and_submit_third_party(request, headers: {})
-      endpoint = '/storeDetailAndSubmitThirdParty'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/storeDetailAndSubmitThirdParty')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -34,9 +30,7 @@ module Adyen
 
     # Submit a payout
     def submit_third_party(request, headers: {})
-      endpoint = '/submitThirdParty'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/submitThirdParty')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/payout/instant_payouts_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Make an instant card payout
     def payout(request, headers: {})
-      endpoint = '/payout'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/payout')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/payout/reviewing_api.rb

@@ -14,9 +14,7 @@ module Adyen
 
     # Confirm a payout
     def confirm_third_party(request, headers: {})
-      endpoint = '/confirmThirdParty'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/confirmThirdParty')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -24,9 +22,7 @@ module Adyen
 
     # Cancel a payout
     def decline_third_party(request, headers: {})
-      endpoint = '/declineThirdParty'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/declineThirdParty')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/posMobile/pos_mobile_api.rb

@@ -13,10 +13,13 @@ module Adyen
     end
 
     # Create a communication session
+    #
+    # Deprecated since POS Mobile API v68
+    # Use POST [/auth/certificate](https://docs.adyen.com/api-explorer/softpos-configuration-api/latest/post/auth/certificate) to establish secure communications.
+    # @deprecated
     def create_communication_session(request, headers: {})
-      endpoint = '/sessions'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      Adyen::Deprecation.warn(:create_communication_session, since: 'POS Mobile API v68', message: 'Use POST [/auth/certificate](https://docs.adyen.com/api-explorer/softpos-configuration-api/latest/post/auth/certificate) to establish secure communications.')
+      endpoint = build_endpoint('/sessions')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/posTerminalManagement.rb

@@ -17,7 +17,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def assign_terminals(request, headers: {})
+      Adyen::Deprecation.warn(:assign_terminals, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/assignTerminals'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -30,7 +32,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def find_terminal(request, headers: {})
+      Adyen::Deprecation.warn(:find_terminal, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/findTerminal'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -43,7 +47,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_stores_under_account(request, headers: {})
+      Adyen::Deprecation.warn(:get_stores_under_account, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getStoresUnderAccount'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -56,7 +62,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_terminal_details(request, headers: {})
+      Adyen::Deprecation.warn(:get_terminal_details, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getTerminalDetails'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)
@@ -69,7 +77,9 @@ module Adyen
     #
     # Deprecated since POS Terminal Management API v1
     # Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).
+    # @deprecated
     def get_terminals_under_account(request, headers: {})
+      Adyen::Deprecation.warn(:get_terminals_under_account, since: 'POS Terminal Management API v1', message: "Use [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).")
       endpoint = '/getTerminalsUnderAccount'.gsub(/{.+?}/, '%s')
       endpoint = endpoint.gsub(%r{^/}, '')
       endpoint = format(endpoint)

data/lib/adyen/services/recurring/recurring_api.rb

@@ -15,10 +15,10 @@ module Adyen
     # Create new permits linked to a recurring contract.
     #
     # Deprecated since Adyen Recurring API v68
+    # @deprecated
     def create_permit(request, headers: {})
-      endpoint = '/createPermit'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      Adyen::Deprecation.warn(:create_permit, since: 'Adyen Recurring API v68')
+      endpoint = build_endpoint('/createPermit')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -26,9 +26,7 @@ module Adyen
 
     # Disable stored payment details
     def disable(request, headers: {})
-      endpoint = '/disable'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/disable')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -37,10 +35,10 @@ module Adyen
     # Disable an existing permit.
     #
     # Deprecated since Adyen Recurring API v68
+    # @deprecated
     def disable_permit(request, headers: {})
-      endpoint = '/disablePermit'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      Adyen::Deprecation.warn(:disable_permit, since: 'Adyen Recurring API v68')
+      endpoint = build_endpoint('/disablePermit')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -48,9 +46,7 @@ module Adyen
 
     # Get stored payment details
     def list_recurring_details(request, headers: {})
-      endpoint = '/listRecurringDetails'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/listRecurringDetails')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -58,9 +54,7 @@ module Adyen
 
     # Ask issuer to notify the shopper
     def notify_shopper(request, headers: {})
-      endpoint = '/notifyShopper'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/notifyShopper')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)
@@ -68,9 +62,7 @@ module Adyen
 
     # Schedule running the Account Updater
     def schedule_account_updater(request, headers: {})
-      endpoint = '/scheduleAccountUpdater'.gsub(/{.+?}/, '%s')
-      endpoint = endpoint.gsub(%r{^/}, '')
-      endpoint = format(endpoint)
+      endpoint = build_endpoint('/scheduleAccountUpdater')
       
       action = { method: 'post', url: endpoint }
       @client.call_adyen_api(@service, action, request, headers, @version)

data/lib/adyen/services/service.rb

@@ -1,3 +1,5 @@
+require_relative '../deprecation'
+
 module Adyen
   class Service
     attr_accessor :service, :version
@@ -27,8 +29,16 @@ module Adyen
     end
 
     # create query parameter from a hash
-    def create_query_string(arr)
-      "?#{URI.encode_www_form(arr)}"
+    def create_query_string(params)
+      return '' if params.empty?
+      "?#{URI.encode_www_form(params)}"
+    end
+
+    private
+
+    def build_endpoint(path, *params)
+      endpoint = path.gsub('%', '%%').gsub(/{.+?}/, '%s').delete_prefix('/')
+      format(endpoint, *params)
     end
   end
 end