auto generated management API

Author: antolo-arch

Adyen/__init__.py

@@ -19,6 +19,7 @@
     AdyenRecurring,
     AdyenPayment,
     AdyenThirdPartyPayout,
+    AdyenManagementApi,
     AdyenCheckoutApi,
     AdyenTerminal
 )
@@ -35,6 +36,7 @@ def __init__(self, **kwargs):
         self.recurring = AdyenRecurring(client=self.client)
         self.checkout = AdyenCheckoutApi(client=self.client)
         self.terminal = AdyenTerminal(client=self.client)
+        self.management = AdyenManagementApi(client=self.client)
 
 
 _base_adyen_obj = Adyen()
@@ -44,3 +46,4 @@ def __init__(self, **kwargs):
 checkout = _base_adyen_obj.checkout
 binlookup = _base_adyen_obj.binlookup
 terminal = _base_adyen_obj.terminal
+management = _base_adyen_obj.management

Adyen/client.py

@@ -83,6 +83,7 @@ def __init__(
         api_bin_lookup_version=None,
         api_checkout_utility_version=None,
         api_checkout_version=None,
+        api_management_version=None,
         api_payment_version=None,
         api_payout_version=None,
         api_recurring_version=None,
@@ -109,6 +110,7 @@ def __init__(
         self.api_bin_lookup_version = api_bin_lookup_version or settings.API_BIN_LOOKUP_VERSION
         self.api_checkout_utility_version = api_checkout_utility_version or settings.API_CHECKOUT_UTILITY_VERSION
         self.api_checkout_version = api_checkout_version or settings.API_CHECKOUT_VERSION
+        self.api_management_version = api_management_version or settings.API_MANAGEMENT_VERSION
         self.api_payment_version = api_payment_version or settings.API_PAYMENT_VERSION
         self.api_payout_version = api_payout_version or settings.API_PAYOUT_VERSION
         self.api_recurring_version = api_recurring_version or settings.API_RECURRING_VERSION
@@ -170,6 +172,15 @@ def _determine_checkout_url(self, platform, endpoint):
 
         return '/'.join([base_uri, api_version, endpoint])
 
+    def _determine_management_url(self, platform, endpoint):
+        api_version = self.api_management_version
+        if platform == "test":
+            base_uri = settings.ENDPOINT_MANAGEMENT_TEST
+        else:
+            base_uri = settings.ENDPOINT_MANAGEMENT_LIVE
+
+        return '/'.join([base_uri, api_version, endpoint])
+
     def _review_payout_username(self, **kwargs):
         if 'username' in kwargs:
             return kwargs['username']
@@ -452,6 +463,72 @@ def call_checkout_api(self, request_data, method, endpoint, idempotency_key=None
 
         return adyen_result
 
+    def call_management_api(self, request_data, method, endpoint, idempotency_key=None,
+                            **kwargs):
+        """This will call the checkout adyen api. xapi key merchant_account,
+        and platform are pulled from root module level and or self object.
+        AdyenResult will be returned on 200 response. Otherwise, an exception
+        is raised.
+
+        Args:
+            idempotency_key: https://docs.adyen.com/development-resources
+            /api-idempotency
+            request_data (dict): The dictionary of the request to place. This
+                should be in the structure of the Adyen API.
+                https://docs.adyen.com/api-explorer/#/CheckoutService
+            method (str): This is the method used to send the request to an endpoint.
+            endpoint (str): The specific endpoint of the API service to be called
+        """
+        if not self.http_init:
+            self._init_http_client()
+
+        # xapi at self object has highest priority. fallback to root module
+        # and ensure that it is set.
+        xapikey = False
+        if self.xapikey:
+            xapikey = self.xapikey
+        elif 'xapikey' in kwargs:
+            xapikey = kwargs.pop("xapikey")
+
+        if not xapikey:
+            errorstring = """Please set your webservice xapikey.
+             You can do this by running 'Adyen.xapikey = 'Your xapikey'"""
+            raise AdyenInvalidRequestError(errorstring)
+
+        # platform at self object has highest priority. fallback to root module
+        # and ensure that it is set to either 'live' or 'test'.
+        platform = None
+        if self.platform:
+            platform = self.platform
+        elif 'platform' in kwargs:
+            platform = kwargs.pop('platform')
+
+        if not isinstance(platform, str):
+            errorstring = "'platform' value must be type of string"
+            raise TypeError(errorstring)
+        elif platform.lower() not in ['live', 'test']:
+            errorstring = "'platform' must be the value of 'live' or 'test'"
+            raise ValueError(errorstring)
+
+        # Adyen requires this header to be set and uses the combination of
+        # merchant account and merchant reference to determine uniqueness.
+        headers = {}
+        if idempotency_key:
+            headers[self.IDEMPOTENCY_HEADER_NAME] = idempotency_key
+        url = self._determine_management_url(platform, endpoint)
+
+        raw_response, raw_request, status_code, headers = \
+            self.http_client.request(method, url, json=request_data,
+                                     xapikey=xapikey, headers=headers,
+                                     **kwargs)
+
+        # Creates AdyenResponse if request was successful, raises error if not.
+        adyen_result = self._handle_response(url, raw_response, raw_request,
+                                             status_code, headers,
+                                             request_data)
+
+        return adyen_result
+
     def _handle_response(self, url, raw_response, raw_request,
                          status_code, headers, request_dict):
         """This parses the content from raw communication, raising an error if
@@ -469,7 +546,8 @@ def _handle_response(self, url, raw_response, raw_request,
         Returns:
             AdyenResult: Result object if successful.
         """
-        if status_code != 200 and status_code != 201:
+
+        if status_code != 200 and status_code != 201 and status_code != 204:
             response = {}
             # If the result can't be parsed into json, most likely is raw html.
             # Some response are neither json or raw html, handle them here:
@@ -502,7 +580,10 @@ def _handle_response(self, url, raw_response, raw_request,
                 erstr = 'KeyError: errorCode'
                 raise AdyenAPICommunicationError(erstr)
         else:
-            response = json_lib.loads(raw_response)
+            if status_code != 204:
+                response = json_lib.loads(raw_response)
+            else:
+                response = {}
             psp = self._get_psp(response, headers)
             return AdyenResult(message=response, status_code=status_code,
                                psp=psp, raw_request=raw_request,

Adyen/services/__init__.py

@@ -5,3 +5,4 @@
 from .payouts import AdyenThirdPartyPayout
 from .recurring import AdyenRecurring
 from .terminal import AdyenTerminal
+from .management import AdyenManagementApi

Adyen/services/management.py

@@ -0,0 +1,76 @@
+"""
+    Management API
+
+    Configure and manage your Adyen company and merchant accounts, stores, and payment terminals. ## Authentication Each request to the Management API must be signed with an API key. [Generate your API key](https://docs.adyen.com/development-resources/api-credentials#generate-api-key) in the Customer Area and then set this key to the `X-API-Key` header value.  To access the live endpoints, you need to generate a new API key in your live Customer Area. ## Versioning  Management API handles versioning as part of the endpoint URL. For example, to send a request to version 1 of the `/companies/{companyId}/webhooks` endpoint, use:  ```text https://management-test.adyen.com/v1/companies/{companyId}/webhooks ```  ## Going live  To access the live endpoints, you need an API key from your live Customer Area. Use this API key to make requests to:  ```text https://management-live.adyen.com/v1 ```  # noqa: E501
+
+    The version of the OpenAPI document: 1
+    Contact: developer-experience@adyen.com
+    Generated by: https://openapi-generator.tech
+"""
+
+from .base import AdyenServiceBase
+from .management_dir.api_credentials_company_level_api import APICredentialsCompanyLevelApi
+from .management_dir.api_credentials_merchant_level_api import APICredentialsMerchantLevelApi
+from .management_dir.api_key_company_level_api import APIKeyCompanyLevelApi
+from .management_dir.api_key_merchant_level_api import APIKeyMerchantLevelApi
+from .management_dir.account_company_level_api import AccountCompanyLevelApi
+from .management_dir.account_merchant_level_api import AccountMerchantLevelApi
+from .management_dir.account_store_level_api import AccountStoreLevelApi
+from .management_dir.allowed_origins_company_level_api import AllowedOriginsCompanyLevelApi
+from .management_dir.allowed_origins_merchant_level_api import AllowedOriginsMerchantLevelApi
+from .management_dir.client_key_company_level_api import ClientKeyCompanyLevelApi
+from .management_dir.client_key_merchant_level_api import ClientKeyMerchantLevelApi
+from .management_dir.my_api_credential_api import MyAPICredentialApi
+from .management_dir.payment_methods_merchant_level_api import PaymentMethodsMerchantLevelApi
+from .management_dir.payout_settings_merchant_level_api import PayoutSettingsMerchantLevelApi
+from .management_dir.terminal_actions_company_level_api import TerminalActionsCompanyLevelApi
+from .management_dir.terminal_actions_terminal_level_api import TerminalActionsTerminalLevelApi
+from .management_dir.terminal_orders_company_level_api import TerminalOrdersCompanyLevelApi
+from .management_dir.terminal_orders_merchant_level_api import TerminalOrdersMerchantLevelApi
+from .management_dir.terminal_settings_company_level_api import TerminalSettingsCompanyLevelApi
+from .management_dir.terminal_settings_merchant_level_api import TerminalSettingsMerchantLevelApi
+from .management_dir.terminal_settings_store_level_api import TerminalSettingsStoreLevelApi
+from .management_dir.terminal_settings_terminal_level_api import TerminalSettingsTerminalLevelApi
+from .management_dir.terminals_terminal_level_api import TerminalsTerminalLevelApi
+from .management_dir.users_company_level_api import UsersCompanyLevelApi
+from .management_dir.users_merchant_level_api import UsersMerchantLevelApi
+from .management_dir.webhooks_company_level_api import WebhooksCompanyLevelApi
+from .management_dir.webhooks_merchant_level_api import WebhooksMerchantLevelApi
+
+
+class AdyenManagementApi(AdyenServiceBase):
+    """NOTE: This class is auto generated by OpenAPI Generator
+    Ref: https://openapi-generator.tech
+
+    Do not edit the class manually.
+    """
+
+    def __init__(self, client=None):
+        super(AdyenManagementApi, self).__init__(client=client)
+        self.api_credentials_company_level_api = APICredentialsCompanyLevelApi(client=client)
+        self.api_credentials_merchant_level_api = APICredentialsMerchantLevelApi(client=client)
+        self.api_key_company_level_api = APIKeyCompanyLevelApi(client=client)
+        self.api_key_merchant_level_api = APIKeyMerchantLevelApi(client=client)
+        self.account_company_level_api = AccountCompanyLevelApi(client=client)
+        self.account_merchant_level_api = AccountMerchantLevelApi(client=client)
+        self.account_store_level_api = AccountStoreLevelApi(client=client)
+        self.allowed_origins_company_level_api = AllowedOriginsCompanyLevelApi(client=client)
+        self.allowed_origins_merchant_level_api = AllowedOriginsMerchantLevelApi(client=client)
+        self.client_key_company_level_api = ClientKeyCompanyLevelApi(client=client)
+        self.client_key_merchant_level_api = ClientKeyMerchantLevelApi(client=client)
+        self.my_api_credential_api = MyAPICredentialApi(client=client)
+        self.payment_methods_merchant_level_api = PaymentMethodsMerchantLevelApi(client=client)
+        self.payout_settings_merchant_level_api = PayoutSettingsMerchantLevelApi(client=client)
+        self.terminal_actions_company_level_api = TerminalActionsCompanyLevelApi(client=client)
+        self.terminal_actions_terminal_level_api = TerminalActionsTerminalLevelApi(client=client)
+        self.terminal_orders_company_level_api = TerminalOrdersCompanyLevelApi(client=client)
+        self.terminal_orders_merchant_level_api = TerminalOrdersMerchantLevelApi(client=client)
+        self.terminal_settings_company_level_api = TerminalSettingsCompanyLevelApi(client=client)
+        self.terminal_settings_merchant_level_api = TerminalSettingsMerchantLevelApi(client=client)
+        self.terminal_settings_store_level_api = TerminalSettingsStoreLevelApi(client=client)
+        self.terminal_settings_terminal_level_api = TerminalSettingsTerminalLevelApi(client=client)
+        self.terminals_terminal_level_api = TerminalsTerminalLevelApi(client=client)
+        self.users_company_level_api = UsersCompanyLevelApi(client=client)
+        self.users_merchant_level_api = UsersMerchantLevelApi(client=client)
+        self.webhooks_company_level_api = WebhooksCompanyLevelApi(client=client)
+        self.webhooks_merchant_level_api = WebhooksMerchantLevelApi(client=client)

Adyen/services/management_dir/__init__.py

@@ -0,0 +1,53 @@
+"""
+    Management API
+
+    Configure and manage your Adyen company and merchant accounts, stores, and payment terminals. ## Authentication Each request to the Management API must be signed with an API key. [Generate your API key](https://docs.adyen.com/development-resources/api-credentials#generate-api-key) in the Customer Area and then set this key to the `X-API-Key` header value.  To access the live endpoints, you need to generate a new API key in your live Customer Area. ## Versioning  Management API handles versioning as part of the endpoint URL. For example, to send a request to version 1 of the `/companies/{companyId}/webhooks` endpoint, use:  ```text https://management-test.adyen.com/v1/companies/{companyId}/webhooks ```  ## Going live  To access the live endpoints, you need an API key from your live Customer Area. Use this API key to make requests to:  ```text https://management-live.adyen.com/v1 ```  # noqa: E501
+
+    The version of the OpenAPI document: 1
+    Contact: developer-experience@adyen.com
+    Generated by: https://openapi-generator.tech
+"""
+
+from ..base import AdyenServiceBase
+
+
+class AccountCompanyLevelApi(AdyenServiceBase):
+    """NOTE: This class is auto generated by OpenAPI Generator
+    Ref: https://openapi-generator.tech
+
+    Do not edit the class manually.
+    """
+
+    def __init__(self, client=None):
+        super(AccountCompanyLevelApi, self).__init__(client=client)
+        self.service = "management"
+
+    def get_companies(self, idempotency_key=None, **kwargs):
+        """
+        Get a list of company accounts
+        """
+        endpoint = f"/companies"
+        endpoint = endpoint.replace('/','',1)
+        method = "GET"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+    def get_companies_company_id(self, companyId, idempotency_key=None, **kwargs):
+        """
+        Get a company account
+        """
+        endpoint = f"/companies/{companyId}"
+        endpoint = endpoint.replace('/','',1)
+        method = "GET"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+    def get_companies_company_id_merchants(self, companyId, idempotency_key=None, **kwargs):
+        """
+        Get a list of merchant accounts
+        """
+        endpoint = f"/companies/{companyId}/merchants"
+        endpoint = endpoint.replace('/','',1)
+        method = "GET"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+
+

Adyen/services/management_dir/account_company_level_api.py

@@ -0,0 +1,62 @@
+"""
+    Management API
+
+    Configure and manage your Adyen company and merchant accounts, stores, and payment terminals. ## Authentication Each request to the Management API must be signed with an API key. [Generate your API key](https://docs.adyen.com/development-resources/api-credentials#generate-api-key) in the Customer Area and then set this key to the `X-API-Key` header value.  To access the live endpoints, you need to generate a new API key in your live Customer Area. ## Versioning  Management API handles versioning as part of the endpoint URL. For example, to send a request to version 1 of the `/companies/{companyId}/webhooks` endpoint, use:  ```text https://management-test.adyen.com/v1/companies/{companyId}/webhooks ```  ## Going live  To access the live endpoints, you need an API key from your live Customer Area. Use this API key to make requests to:  ```text https://management-live.adyen.com/v1 ```  # noqa: E501
+
+    The version of the OpenAPI document: 1
+    Contact: developer-experience@adyen.com
+    Generated by: https://openapi-generator.tech
+"""
+
+from ..base import AdyenServiceBase
+
+
+class AccountMerchantLevelApi(AdyenServiceBase):
+    """NOTE: This class is auto generated by OpenAPI Generator
+    Ref: https://openapi-generator.tech
+
+    Do not edit the class manually.
+    """
+
+    def __init__(self, client=None):
+        super(AccountMerchantLevelApi, self).__init__(client=client)
+        self.service = "management"
+
+    def get_merchants(self, idempotency_key=None, **kwargs):
+        """
+        Get a list of merchant accounts
+        """
+        endpoint = f"/merchants"
+        endpoint = endpoint.replace('/','',1)
+        method = "GET"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+    def get_merchants_merchant_id(self, merchantId, idempotency_key=None, **kwargs):
+        """
+        Get a merchant account
+        """
+        endpoint = f"/merchants/{merchantId}"
+        endpoint = endpoint.replace('/','',1)
+        method = "GET"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+    def post_merchants(self, request, idempotency_key=None, **kwargs):
+        """
+        Create a merchant account
+        """
+        endpoint = f"/merchants"
+        endpoint = endpoint.replace('/','',1)
+        method = "POST"
+        return self.client.call_management_api(request, method, endpoint, idempotency_key, **kwargs)
+
+    def post_merchants_merchant_id_activate(self, merchantId, idempotency_key=None, **kwargs):
+        """
+        Request to activate a merchant account
+        """
+        endpoint = f"/merchants/{merchantId}/activate"
+        endpoint = endpoint.replace('/','',1)
+        method = "POST"
+        return self.client.call_management_api(None, method, endpoint, idempotency_key, **kwargs)
+
+
+