onlinepayments-sdk-python3 4.23.0__zip → 5.0.0__zip

{onlinepayments-sdk-python3-4.23.0 → onlinepayments_sdk_python3-5.0.0}/onlinepayments/sdk/merchant/mandates/mandates_client.py

@@ -1,14 +1,19 @@
+# -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
+from typing import Mapping, Optional
+
+from .i_mandates_client import IMandatesClient
+
 from onlinepayments.sdk.api_resource import ApiResource
 from onlinepayments.sdk.call_context import CallContext
-from onlinepayments.sdk.response_exception import ResponseException
+from onlinepayments.sdk.communication.response_exception import ResponseException
 from onlinepayments.sdk.domain.create_mandate_request import CreateMandateRequest
 from onlinepayments.sdk.domain.create_mandate_response import CreateMandateResponse
 from onlinepayments.sdk.domain.error_response import ErrorResponse
 from onlinepayments.sdk.domain.get_mandate_response import GetMandateResponse
-from onlinepayments.sdk.merchant.mandates.i_mandates_client import IMandatesClient
+from onlinepayments.sdk.exception_factory import create_exception
 
 
 class MandatesClient(ApiResource, IMandatesClient):
@@ -16,61 +21,61 @@ class MandatesClient(ApiResource, IMandatesClient):
     Mandates client. Thread-safe.
     """
 
-    def __init__(self, parent, path_context):
+    def __init__(self, parent: ApiResource, path_context: Optional[Mapping[str, str]]):
         """
         :param parent:       :class:`onlinepayments.sdk.api_resource.ApiResource`
-        :param path_context: dict[str, str]
+        :param path_context: Mapping[str, str]
         """
-        super(MandatesClient, self).__init__(parent, path_context)
+        super(MandatesClient, self).__init__(parent=parent, path_context=path_context)
 
-    def create_mandate(self, body: CreateMandateRequest, context: CallContext = None) -> CreateMandateResponse:
+    def create_mandate(self, body: CreateMandateRequest, context: Optional[CallContext] = None) -> CreateMandateResponse:
         """
         Resource /v2/{merchantId}/mandates - Create mandate
 
-
-        :param body: :class:`onlinepayments.sdk.domain.create_mandate_request.CreateMandateRequest`
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param body:     :class:`onlinepayments.sdk.domain.create_mandate_request.CreateMandateRequest`
+        :param context:  :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.create_mandate_response.CreateMandateResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
         uri = self._instantiate_uri("/v2/{merchantId}/mandates", None)
         try:
             return self._communicator.post(
-                uri,
-                self._client_headers,
-                None,
-                body,
-                CreateMandateResponse,
-                context)
+                    uri,
+                    self._client_headers,
+                    None,
+                    body,
+                    CreateMandateResponse,
+                    context)
 
         except ResponseException as e:
             error_type = ErrorResponse
             error_object = self._communicator.marshaller.unmarshal(e.body, error_type)
-            raise self._create_exception(e.status_code, e.body, error_object, context)
+            raise create_exception(e.status_code, e.body, error_object, context)
 
-    def get_mandate(self, unique_mandate_reference: str, context: CallContext = None) -> GetMandateResponse:
+    def get_mandate(self, unique_mandate_reference: str, context: Optional[CallContext] = None) -> GetMandateResponse:
         """
         Resource /v2/{merchantId}/mandates/{uniqueMandateReference} - Get mandate
 
-
-        :param unique_mandate_reference: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param unique_mandate_reference:  str
+        :param context:                   :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.get_mandate_response.GetMandateResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
         path_context = {
             "uniqueMandateReference": unique_mandate_reference,
@@ -78,33 +83,33 @@ class MandatesClient(ApiResource, IMandatesClient):
         uri = self._instantiate_uri("/v2/{merchantId}/mandates/{uniqueMandateReference}", path_context)
         try:
             return self._communicator.get(
-                uri,
-                self._client_headers,
-                None,
-                GetMandateResponse,
-                context)
+                    uri,
+                    self._client_headers,
+                    None,
+                    GetMandateResponse,
+                    context)
 
         except ResponseException as e:
             error_type = ErrorResponse
             error_object = self._communicator.marshaller.unmarshal(e.body, error_type)
-            raise self._create_exception(e.status_code, e.body, error_object, context)
+            raise create_exception(e.status_code, e.body, error_object, context)
 
-    def block_mandate(self, unique_mandate_reference: str, context: CallContext = None) -> GetMandateResponse:
+    def block_mandate(self, unique_mandate_reference: str, context: Optional[CallContext] = None) -> GetMandateResponse:
         """
         Resource /v2/{merchantId}/mandates/{uniqueMandateReference}/block - Block mandate
 
-
-        :param unique_mandate_reference: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param unique_mandate_reference:  str
+        :param context:                   :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.get_mandate_response.GetMandateResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
         path_context = {
             "uniqueMandateReference": unique_mandate_reference,
@@ -112,34 +117,34 @@ class MandatesClient(ApiResource, IMandatesClient):
         uri = self._instantiate_uri("/v2/{merchantId}/mandates/{uniqueMandateReference}/block", path_context)
         try:
             return self._communicator.post(
-                uri,
-                self._client_headers,
-                None,
-                None,
-                GetMandateResponse,
-                context)
+                    uri,
+                    self._client_headers,
+                    None,
+                    None,
+                    GetMandateResponse,
+                    context)
 
         except ResponseException as e:
             error_type = ErrorResponse
             error_object = self._communicator.marshaller.unmarshal(e.body, error_type)
-            raise self._create_exception(e.status_code, e.body, error_object, context)
+            raise create_exception(e.status_code, e.body, error_object, context)
 
-    def unblock_mandate(self, unique_mandate_reference: str, context: CallContext = None) -> GetMandateResponse:
+    def unblock_mandate(self, unique_mandate_reference: str, context: Optional[CallContext] = None) -> GetMandateResponse:
         """
         Resource /v2/{merchantId}/mandates/{uniqueMandateReference}/unblock - Unblock mandate
 
-
-        :param unique_mandate_reference: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param unique_mandate_reference:  str
+        :param context:                   :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.get_mandate_response.GetMandateResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
         path_context = {
             "uniqueMandateReference": unique_mandate_reference,
@@ -147,34 +152,34 @@ class MandatesClient(ApiResource, IMandatesClient):
         uri = self._instantiate_uri("/v2/{merchantId}/mandates/{uniqueMandateReference}/unblock", path_context)
         try:
             return self._communicator.post(
-                uri,
-                self._client_headers,
-                None,
-                None,
-                GetMandateResponse,
-                context)
+                    uri,
+                    self._client_headers,
+                    None,
+                    None,
+                    GetMandateResponse,
+                    context)
 
         except ResponseException as e:
             error_type = ErrorResponse
             error_object = self._communicator.marshaller.unmarshal(e.body, error_type)
-            raise self._create_exception(e.status_code, e.body, error_object, context)
+            raise create_exception(e.status_code, e.body, error_object, context)
 
-    def revoke_mandate(self, unique_mandate_reference: str, context: CallContext = None) -> GetMandateResponse:
+    def revoke_mandate(self, unique_mandate_reference: str, context: Optional[CallContext] = None) -> GetMandateResponse:
         """
         Resource /v2/{merchantId}/mandates/{uniqueMandateReference}/revoke - Revoke mandate
 
-
-        :param unique_mandate_reference: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param unique_mandate_reference:  str
+        :param context:                   :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.get_mandate_response.GetMandateResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
         path_context = {
             "uniqueMandateReference": unique_mandate_reference,
@@ -182,14 +187,14 @@ class MandatesClient(ApiResource, IMandatesClient):
         uri = self._instantiate_uri("/v2/{merchantId}/mandates/{uniqueMandateReference}/revoke", path_context)
         try:
             return self._communicator.post(
-                uri,
-                self._client_headers,
-                None,
-                None,
-                GetMandateResponse,
-                context)
+                    uri,
+                    self._client_headers,
+                    None,
+                    None,
+                    GetMandateResponse,
+                    context)
 
         except ResponseException as e:
             error_type = ErrorResponse
             error_object = self._communicator.marshaller.unmarshal(e.body, error_type)
-            raise self._create_exception(e.status_code, e.body, error_object, context)
+            raise create_exception(e.status_code, e.body, error_object, context)

onlinepayments_sdk_python3-5.0.0/onlinepayments/sdk/merchant/merchant_client.py

@@ -0,0 +1,182 @@
+# -*- coding: utf-8 -*-
+#
+# This file was automatically generated.
+#
+from typing import Mapping, Optional
+
+from .i_merchant_client import IMerchantClient
+
+from onlinepayments.sdk.api_resource import ApiResource
+from onlinepayments.sdk.merchant.captures.captures_client import CapturesClient
+from onlinepayments.sdk.merchant.captures.i_captures_client import ICapturesClient
+from onlinepayments.sdk.merchant.complete.complete_client import CompleteClient
+from onlinepayments.sdk.merchant.complete.i_complete_client import ICompleteClient
+from onlinepayments.sdk.merchant.hostedcheckout.hosted_checkout_client import HostedCheckoutClient
+from onlinepayments.sdk.merchant.hostedcheckout.i_hosted_checkout_client import IHostedCheckoutClient
+from onlinepayments.sdk.merchant.hostedtokenization.hosted_tokenization_client import HostedTokenizationClient
+from onlinepayments.sdk.merchant.hostedtokenization.i_hosted_tokenization_client import IHostedTokenizationClient
+from onlinepayments.sdk.merchant.mandates.i_mandates_client import IMandatesClient
+from onlinepayments.sdk.merchant.mandates.mandates_client import MandatesClient
+from onlinepayments.sdk.merchant.paymentlinks.i_payment_links_client import IPaymentLinksClient
+from onlinepayments.sdk.merchant.paymentlinks.payment_links_client import PaymentLinksClient
+from onlinepayments.sdk.merchant.payments.i_payments_client import IPaymentsClient
+from onlinepayments.sdk.merchant.payments.payments_client import PaymentsClient
+from onlinepayments.sdk.merchant.payouts.i_payouts_client import IPayoutsClient
+from onlinepayments.sdk.merchant.payouts.payouts_client import PayoutsClient
+from onlinepayments.sdk.merchant.privacypolicy.i_privacy_policy_client import IPrivacyPolicyClient
+from onlinepayments.sdk.merchant.privacypolicy.privacy_policy_client import PrivacyPolicyClient
+from onlinepayments.sdk.merchant.productgroups.i_product_groups_client import IProductGroupsClient
+from onlinepayments.sdk.merchant.productgroups.product_groups_client import ProductGroupsClient
+from onlinepayments.sdk.merchant.products.i_products_client import IProductsClient
+from onlinepayments.sdk.merchant.products.products_client import ProductsClient
+from onlinepayments.sdk.merchant.refunds.i_refunds_client import IRefundsClient
+from onlinepayments.sdk.merchant.refunds.refunds_client import RefundsClient
+from onlinepayments.sdk.merchant.services.i_services_client import IServicesClient
+from onlinepayments.sdk.merchant.services.services_client import ServicesClient
+from onlinepayments.sdk.merchant.sessions.i_sessions_client import ISessionsClient
+from onlinepayments.sdk.merchant.sessions.sessions_client import SessionsClient
+from onlinepayments.sdk.merchant.tokens.i_tokens_client import ITokensClient
+from onlinepayments.sdk.merchant.tokens.tokens_client import TokensClient
+from onlinepayments.sdk.merchant.webhooks.i_webhooks_client import IWebhooksClient
+from onlinepayments.sdk.merchant.webhooks.webhooks_client import WebhooksClient
+
+
+class MerchantClient(ApiResource, IMerchantClient):
+    """
+    Merchant client. Thread-safe.
+    """
+
+    def __init__(self, parent: ApiResource, path_context: Optional[Mapping[str, str]]):
+        """
+        :param parent:       :class:`onlinepayments.sdk.api_resource.ApiResource`
+        :param path_context: Mapping[str, str]
+        """
+        super(MerchantClient, self).__init__(parent=parent, path_context=path_context)
+
+    def hosted_checkout(self) -> IHostedCheckoutClient:
+        """
+        Resource /v2/{merchantId}/hostedcheckouts
+
+        :return: :class:`onlinepayments.sdk.merchant.hostedcheckout.i_hosted_checkout_client.IHostedCheckoutClient`
+        """
+        return HostedCheckoutClient(self, None)
+
+    def hosted_tokenization(self) -> IHostedTokenizationClient:
+        """
+        Resource /v2/{merchantId}/hostedtokenizations
+
+        :return: :class:`onlinepayments.sdk.merchant.hostedtokenization.i_hosted_tokenization_client.IHostedTokenizationClient`
+        """
+        return HostedTokenizationClient(self, None)
+
+    def payments(self) -> IPaymentsClient:
+        """
+        Resource /v2/{merchantId}/payments
+
+        :return: :class:`onlinepayments.sdk.merchant.payments.i_payments_client.IPaymentsClient`
+        """
+        return PaymentsClient(self, None)
+
+    def captures(self) -> ICapturesClient:
+        """
+        Resource /v2/{merchantId}/payments/{paymentId}/captures
+
+        :return: :class:`onlinepayments.sdk.merchant.captures.i_captures_client.ICapturesClient`
+        """
+        return CapturesClient(self, None)
+
+    def refunds(self) -> IRefundsClient:
+        """
+        Resource /v2/{merchantId}/payments/{paymentId}/refunds
+
+        :return: :class:`onlinepayments.sdk.merchant.refunds.i_refunds_client.IRefundsClient`
+        """
+        return RefundsClient(self, None)
+
+    def complete(self) -> ICompleteClient:
+        """
+        Resource /v2/{merchantId}/payments/{paymentId}/complete
+
+        :return: :class:`onlinepayments.sdk.merchant.complete.i_complete_client.ICompleteClient`
+        """
+        return CompleteClient(self, None)
+
+    def product_groups(self) -> IProductGroupsClient:
+        """
+        Resource /v2/{merchantId}/productgroups
+
+        :return: :class:`onlinepayments.sdk.merchant.productgroups.i_product_groups_client.IProductGroupsClient`
+        """
+        return ProductGroupsClient(self, None)
+
+    def products(self) -> IProductsClient:
+        """
+        Resource /v2/{merchantId}/products
+
+        :return: :class:`onlinepayments.sdk.merchant.products.i_products_client.IProductsClient`
+        """
+        return ProductsClient(self, None)
+
+    def services(self) -> IServicesClient:
+        """
+        Resource /v2/{merchantId}/services/testconnection
+
+        :return: :class:`onlinepayments.sdk.merchant.services.i_services_client.IServicesClient`
+        """
+        return ServicesClient(self, None)
+
+    def webhooks(self) -> IWebhooksClient:
+        """
+        Resource /v2/{merchantId}/webhooks/validateCredentials
+
+        :return: :class:`onlinepayments.sdk.merchant.webhooks.i_webhooks_client.IWebhooksClient`
+        """
+        return WebhooksClient(self, None)
+
+    def sessions(self) -> ISessionsClient:
+        """
+        Resource /v2/{merchantId}/sessions
+
+        :return: :class:`onlinepayments.sdk.merchant.sessions.i_sessions_client.ISessionsClient`
+        """
+        return SessionsClient(self, None)
+
+    def tokens(self) -> ITokensClient:
+        """
+        Resource /v2/{merchantId}/tokens/{tokenId}
+
+        :return: :class:`onlinepayments.sdk.merchant.tokens.i_tokens_client.ITokensClient`
+        """
+        return TokensClient(self, None)
+
+    def payouts(self) -> IPayoutsClient:
+        """
+        Resource /v2/{merchantId}/payouts/{payoutId}
+
+        :return: :class:`onlinepayments.sdk.merchant.payouts.i_payouts_client.IPayoutsClient`
+        """
+        return PayoutsClient(self, None)
+
+    def mandates(self) -> IMandatesClient:
+        """
+        Resource /v2/{merchantId}/mandates
+
+        :return: :class:`onlinepayments.sdk.merchant.mandates.i_mandates_client.IMandatesClient`
+        """
+        return MandatesClient(self, None)
+
+    def privacy_policy(self) -> IPrivacyPolicyClient:
+        """
+        Resource /v2/{merchantId}/services/privacypolicy
+
+        :return: :class:`onlinepayments.sdk.merchant.privacypolicy.i_privacy_policy_client.IPrivacyPolicyClient`
+        """
+        return PrivacyPolicyClient(self, None)
+
+    def payment_links(self) -> IPaymentLinksClient:
+        """
+        Resource /v2/{merchantId}/paymentlinks
+
+        :return: :class:`onlinepayments.sdk.merchant.paymentlinks.i_payment_links_client.IPaymentLinksClient`
+        """
+        return PaymentLinksClient(self, None)

onlinepayments_sdk_python3-5.0.0/onlinepayments/sdk/merchant/paymentlinks/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+#
+# This file was automatically generated.
+#

{onlinepayments-sdk-python3-4.23.0 → onlinepayments_sdk_python3-5.0.0}/onlinepayments/sdk/merchant/paymentlinks/i_payment_links_client.py

@@ -1,70 +1,73 @@
+# -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
 from abc import ABC, abstractmethod
+from typing import Optional
 
 from onlinepayments.sdk.call_context import CallContext
 from onlinepayments.sdk.domain.create_payment_link_request import CreatePaymentLinkRequest
 from onlinepayments.sdk.domain.payment_link_response import PaymentLinkResponse
 
+
 class IPaymentLinksClient(ABC):
     """
     PaymentLinks client interface. Thread-safe.
     """
 
     @abstractmethod
-    def create_payment_link(self, body: CreatePaymentLinkRequest, context: CallContext = None) -> PaymentLinkResponse:
+    def create_payment_link(self, body: CreatePaymentLinkRequest, context: Optional[CallContext] = None) -> PaymentLinkResponse:
         """
         Resource /v2/{merchantId}/paymentlinks - Create payment link
 
-
-        :param body: :class:`onlinepayments.sdk.domain.create_payment_link_request.CreatePaymentLinkRequest`
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param body:     :class:`onlinepayments.sdk.domain.create_payment_link_request.CreatePaymentLinkRequest`
+        :param context:  :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.payment_link_response.PaymentLinkResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
 
     @abstractmethod
-    def get_payment_link_by_id(self, payment_link_id: str, context: CallContext = None) -> PaymentLinkResponse:
+    def get_payment_link_by_id(self, payment_link_id: str, context: Optional[CallContext] = None) -> PaymentLinkResponse:
         """
         Resource /v2/{merchantId}/paymentlinks/{paymentLinkId} - Get payment link by ID
 
-
-        :param payment_link_id: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param payment_link_id:  str
+        :param context:          :class:`onlinepayments.sdk.call_context.CallContext`
         :return: :class:`onlinepayments.sdk.domain.payment_link_response.PaymentLinkResponse`
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """
 
     @abstractmethod
-    def cancel_payment_link_by_id(self, payment_link_id: str, context: CallContext = None) -> None:
+    def cancel_payment_link_by_id(self, payment_link_id: str, context: Optional[CallContext] = None) -> None:
         """
         Resource /v2/{merchantId}/paymentlinks/{paymentLinkId}/cancel - Cancel PaymentLink by ID
 
-
-        :param payment_link_id: str
-        :param context: :class:`onlinepayments.sdk.call_context.CallContext`
+        :param payment_link_id:  str
+        :param context:          :class:`onlinepayments.sdk.call_context.CallContext`
         :return: None
-        :raise: ValidationException if the request was not correct and couldn't be processed (HTTP status code 400)
-        :raise: AuthorizationException if the request was not allowed (HTTP status code 403)
-        :raise: ReferenceException if an object was attempted to be referenced that doesn't exist or has been removed,
+        :raise IdempotenceException: if an idempotent request caused a conflict (HTTP status code 409)
+        :raise ValidationException: if the request was not correct and couldn't be processed (HTTP status code 400)
+        :raise AuthorizationException: if the request was not allowed (HTTP status code 403)
+        :raise ReferenceException: if an object was attempted to be referenced that doesn't exist or has been removed,
                    or there was a conflict (HTTP status code 404, 409 or 410)
-        :raise: PaymentPlatformException if something went wrong at the payment platform,
+        :raise PlatformException: if something went wrong at the payment platform,
                    the payment platform was unable to process a message from a downstream partner/acquirer,
                    or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
-        :raise: ApiException if the payment platform returned any other error
+        :raise ApiException: if the payment platform returned any other error
         """