Changes from gocardless/client-library-templates

README.rst

@@ -402,7 +402,7 @@ Customer notifications
 .. code:: python
 
     # Handle a notification
-    client.customer_notifications.handle('PCN123', params={...})
+    client.customer_notifications.handle('EV1D18JEXAMPLE', params={...})
 
 Events
 ''''''''''''''''''''''''''''''''''''''''''

gocardless_pro/__init__.py

@@ -2,5 +2,5 @@
 
 from .client import Client
 
-__version__ = '3.5.0'
+__version__ = '3.6.0'
 

gocardless_pro/api_client.py

@@ -172,7 +172,7 @@ def _default_headers(self):
             'Authorization': 'Bearer {0}'.format(self.access_token),
             'Content-Type': 'application/json',
             'GoCardless-Client-Library': 'gocardless-pro-python',
-            'GoCardless-Client-Version': '3.5.0',
+            'GoCardless-Client-Version': '3.6.0',
             'User-Agent': self._user_agent(),
             'GoCardless-Version': '2015-07-06',
         }
@@ -181,7 +181,7 @@ def _user_agent(self):
         python_version = '.'.join(platform.python_version_tuple()[0:2])
         vm_version = '{}.{}.{}-{}{}'.format(*sys.version_info)
         return ' '.join([
-            'gocardless-pro-python/3.5.0',
+            'gocardless-pro-python/3.6.0',
             'python/{0}'.format(python_version),
             '{0}/{1}'.format(platform.python_implementation(), vm_version),
             '{0}/{1}'.format(platform.system(), platform.release()),

gocardless_pro/resources/customer_bank_account.py

@@ -76,6 +76,11 @@ def metadata(self):
         return self.attributes.get('metadata')
 
 
+    @property
+    def payer_name_verification_result(self):
+        return self.attributes.get('payer_name_verification_result')
+
+
     @property
     def trusted_recipient(self):
         return self.attributes.get('trusted_recipient')
@@ -119,3 +124,5 @@ def customer(self):
 
 
 
+
+

gocardless_pro/resources/institution.py

@@ -51,6 +51,11 @@ def name(self):
         return self.attributes.get('name')
 
 
+    @property
+    def roles(self):
+        return self.attributes.get('roles')
+
+
     @property
     def status(self):
         return self.attributes.get('status')
@@ -88,3 +93,5 @@ def single(self):
 
 
 
+
+

gocardless_pro/resources/verification_detail.py

@@ -41,6 +41,11 @@ def company_number(self):
         return self.attributes.get('company_number')
 
 
+    @property
+    def country_code(self):
+        return self.attributes.get('country_code')
+
+
     @property
     def description(self):
         return self.attributes.get('description')
@@ -66,6 +71,13 @@ def postal_code(self):
         return self.attributes.get('postal_code')
 
 
+    @property
+    def region(self):
+        return self.attributes.get('region')
+
+
+
+
 
 
 
@@ -98,3 +110,5 @@ def creditor(self):
 
 
 
+
+

gocardless_pro/services/balances_service.py

@@ -20,9 +20,10 @@ class BalancesService(base_service.BaseService):
     def list(self,params=None, headers=None):
         """List balances.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of
-        balances for a given creditor. This endpoint is rate limited to 60
-        requests per minute.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of balances for a given creditor. This endpoint is rate limited to
+        60 requests per minute.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/bank_account_details_service.py

@@ -24,8 +24,8 @@ def get(self,identity,params=None, headers=None):
         format described in RFC 7516.
 
         You must specify a `Gc-Key-Id` header when using this endpoint. See
-        [Public Key
-        Setup](https://developer.gocardless.com/gc-embed/bank-details-access#public_key_setup)
+        Public Key Setup
+        (https://developer.gocardless.com/gc-embed/bank-details-access#public_key_setup)
         for more details.
 
         Args:

gocardless_pro/services/bank_account_holder_verifications_service.py

@@ -21,9 +21,9 @@ def create(self,params=None, headers=None):
         """Create a bank account holder verification..
 
         Verify the account holder of the bank account. A complete verification
-        can be attached when creating an outbound payment. This endpoint allows
-        partner merchants to create Confirmation of Payee checks on customer
-        bank accounts before sending outbound payments.
+        can be attached when creating an outbound payment.
+        This endpoint allows partner merchants to create Confirmation of Payee
+        checks on customer bank accounts before sending outbound payments.
 
         Args:
               params (dict, optional): Request body.

gocardless_pro/services/bank_details_lookups_service.py

@@ -24,24 +24,30 @@ def create(self,params=None, headers=None):
         and
         reachability check are performed.
 
-        For UK-based bank accounts, where an account holder name is provided
-        (and an account number, a sort code or an iban
-        are already present), we verify that the account holder name and bank
-        account number match the details held by
-        the relevant bank.
+        For UK or Eurozone-based bank accounts, where an account holder name is
+        provided
+        (and an account number, a sort code or an IBAN are already present), we
+        verify that
+        the account holder name and bank account number match the details held
+        by the relevant bank.
+        If there is no match, the endpoint will return a 422 - validation error
+        on account_holder_name:
+        "Account holder name does not match bank account details provided".
 
-        If your request returns an [error](#api-usage-errors) or the
-        `available_debit_schemes`
+        If your request returns an error
+        (https://developer.gocardless.com/api-reference/#api-usage-errors) or
+        the `available_debit_schemes`
         attribute is an empty array, you will not be able to collect payments
         from the
         specified bank account. GoCardless may be able to collect payments from
         an account
         even if no `bic` is returned.
 
-        Bank account details may be supplied using [local
-        details](#appendix-local-bank-details) or an IBAN.
+        Bank account details may be supplied using local details
+        (https://developer.gocardless.com/api-reference/#appendix-local-bank-details)
+        or an IBAN.
 
-        _ACH scheme_ For compliance reasons, an extra validation step is done
+        ACH scheme For compliance reasons, an extra validation step is done
         using
         a third-party provider to make sure the customer's bank account can
         accept
@@ -50,8 +56,8 @@ def create(self,params=None, headers=None):
         customer is requested to adjust the account number/routing number and
         succeed in this check to continue with the flow.
 
-        _Note:_ Usage of this endpoint is monitored. If your organisation
-        relies on GoCardless for
+        Note: Usage of this endpoint is monitored. If your organisation relies
+        on GoCardless for
         modulus or reachability checking but not for payment collection, please
         get in touch.
 

gocardless_pro/services/billing_request_templates_service.py

@@ -20,8 +20,9 @@ class BillingRequestTemplatesService(base_service.BaseService):
     def list(self,params=None, headers=None):
         """List Billing Request Templates.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        Billing Request Templates.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your Billing Request Templates.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/billing_requests_service.py

@@ -20,9 +20,8 @@ class BillingRequestsService(base_service.BaseService):
     def create(self,params=None, headers=None):
         """Create a Billing Request.
 
-        <p class="notice"><strong>Important</strong>: All properties associated
-        with `subscription_request` and `instalment_schedule_request` are only
-        supported for ACH and PAD schemes.</p>
+        Important: All properties associated with subscription_request and
+        instalment_schedule_request are only supported for ACH and PAD schemes.
 
         Args:
               params (dict, optional): Request body.
@@ -50,8 +49,7 @@ def create(self,params=None, headers=None):
     def collect_customer_details(self,identity,params=None, headers=None):
         """Collect customer details.
 
-        If the billing request has a pending
-        <code>collect_customer_details</code>
+        If the billing request has a pending collect_customer_details
         action, this endpoint can be used to collect the details in order to
         complete it.
 
@@ -85,7 +83,7 @@ def collect_bank_account(self,identity,params=None, headers=None):
         """Collect bank account details.
 
         If the billing request has a pending
-        <code>collect_bank_account</code> action, this endpoint can be
+        collect_bank_account action, this endpoint can be
         used to collect the details in order to complete it.
 
         The endpoint takes the same payload as Customer Bank Accounts, but
@@ -98,7 +96,7 @@ def collect_bank_account(self,identity,params=None, headers=None):
         included in the payload along with the
         country_code.
 
-        _ACH scheme_ For compliance reasons, an extra validation step is done
+        ACH scheme For compliance reasons, an extra validation step is done
         using
         a third-party provider to make sure the customer's bank account can
         accept
@@ -107,11 +105,15 @@ def collect_bank_account(self,identity,params=None, headers=None):
         customer is requested to adjust the account number/routing number and
         succeed in this check to continue with the flow.
 
-        _BACS scheme_ [Payer Name
-        Verification](https://hub.gocardless.com/s/article/Introduction-to-Payer-Name-Verification?language=en_GB)
-        is enabled by default for UK based bank accounts, meaning we verify the
-        account holder name and bank account
-        number match the details held by the relevant bank.
+        BACS and SEPA schemes Payer Name Verification
+        (https://hub.gocardless.com/s/article/Introduction-to-Payer-Name-Verification?language=en_GB)
+        is enabled by default for UK and Eurozone based bank accounts, meaning
+        we verify the account holder name and bank account number/IBAN match
+        the details held by the relevant bank. If there is no match, the
+        endpoint will return a 422 - validation error on account_holder_name:
+        "Account holder name does not match bank account details provided".
+        Testing instructions are here
+        (https://developer.gocardless.com/developer-tools/scenario-simulators/#payer_name_verification)
 
         Args:
               identity (string): Unique identifier, beginning with "BRQ".
@@ -214,8 +216,9 @@ def cancel(self,identity,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List Billing Requests.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        billing requests.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your billing requests.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/blocks_service.py

@@ -71,8 +71,9 @@ def get(self,identity,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List multiple blocks.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        blocks.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your blocks.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/creditor_bank_accounts_service.py

@@ -48,8 +48,9 @@ def create(self,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List creditor bank accounts.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        creditor bank accounts.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your creditor bank accounts.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/creditors_service.py

@@ -48,8 +48,9 @@ def create(self,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List creditors.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        creditors.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your creditors.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/currency_exchange_rates_service.py

@@ -20,8 +20,9 @@ class CurrencyExchangeRatesService(base_service.BaseService):
     def list(self,params=None, headers=None):
         """List exchange rates.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of all
-        exchange rates.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of all exchange rates.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/customer_bank_accounts_service.py

@@ -24,15 +24,18 @@ def create(self,params=None, headers=None):
 
         There are three different ways to supply bank account details:
 
-        - [Local details](#appendix-local-bank-details)
-
-        - IBAN
-
-        - [Customer Bank Account
-        Tokens](#javascript-flow-create-a-customer-bank-account-token)
+        - 
+        Local details
+        (https://developer.gocardless.com/api-reference/#appendix-local-bank-details)
+        - 
+        IBAN
+        - 
+        Customer Bank Account Tokens
+        (https://developer.gocardless.com/api-reference/#javascript-flow-create-a-customer-bank-account-token)
 
         For more information on the different fields required in each country,
-        see [local bank details](#appendix-local-bank-details).
+        see local bank details
+        (https://developer.gocardless.com/api-reference/#appendix-local-bank-details).
 
         Args:
               params (dict, optional): Request body.
@@ -60,8 +63,9 @@ def create(self,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List customer bank accounts.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        bank accounts.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your bank accounts.
 
         Args:
               params (dict, optional): Query string parameters.

gocardless_pro/services/customer_notifications_service.py

@@ -28,7 +28,6 @@ def handle(self,identity,params=None, headers=None):
         this endpoint will return an `already_actioned` error and you should
         not take
         further action. This endpoint takes no additional parameters.
-
 
         Args:
               identity (string): The id of the notification.

gocardless_pro/services/customers_service.py

@@ -48,8 +48,9 @@ def create(self,params=None, headers=None):
     def list(self,params=None, headers=None):
         """List customers.
 
-        Returns a [cursor-paginated](#api-usage-cursor-pagination) list of your
-        customers.
+        Returns a cursor-paginated
+        (https://developer.gocardless.com/api-reference/#api-usage-cursor-pagination)
+        list of your customers.
 
         Args:
               params (dict, optional): Query string parameters.
@@ -130,8 +131,8 @@ def remove(self,identity,params=None, headers=None):
         removed customer by
         ID.
 
-        <p class="restricted-notice"><strong>The action of removing a customer
-        cannot be reversed, so please use with care.</strong></p>
+        The action of removing a customer cannot be reversed, so please use
+        with care.
 
         Args:
               identity (string): Unique identifier, beginning with "CU".