From 5efcee9e9075682c66bee8b6bbea5ce2f0a30978 Mon Sep 17 00:00:00 2001
From: "gocardless-ci-robot[bot]"
 <123969075+gocardless-ci-robot[bot]@users.noreply.github.com>
Date: Tue, 6 Oct 2026 10:01:41 +0000
Subject: [PATCH] Changes generated by 6b22b7bf1fa891d4fd2367b98892b17e04152d8f

This commit was automatically created from gocardless/client-library-templates@6b22b7bf1fa891d4fd2367b98892b17e04152d8f
by the `push-files` action.

Workflow run: https://github.com/gocardless/client-library-templates/actions/runs/37446645673
---
 CHANGELOG.md                 | 17 +++++++++++++++++
 gocardless_pro/__init__.py   |  2 +-
 gocardless_pro/api_client.py |  4 ++--
 setup.py                     |  2 +-
 4 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 16db4ae8..6f7e58d8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,23 @@
 <!-- This file is generated, please add to it using `knope document-change` in the client-library-templates repo -->
 # Changelog
 
+## 3.18.2 (2026-10-06)
+
+### Fixes
+
+#### Document `required` fields on several API resource responses
+
+Several resource response schemas were missing `required` field lists,
+even though the fields are always present in the actual response.
+Added accurate `required` arrays (and fixed a few hardcoded docs
+examples that predated them) for: `payment`, `bank_details_lookup`,
+`billing_request_template`, `currency_exchange_rate`, `mandate_import`,
+`mandate_import_entry`, `negative_balance_limit`, `payer_authorisation`,
+`payout`, `payout_item`, `refund`, `scenario_simulator`,
+`scheme_identifier`, `tax_rate`, `verification_detail` and `logo`.
+
+This is a documentation-only change; API behaviour is unchanged.
+
 ## 3.18.1 (2026-10-06)
 
 ### Fixes
diff --git a/gocardless_pro/__init__.py b/gocardless_pro/__init__.py
index b6e69b3e..615f1877 100644
--- a/gocardless_pro/__init__.py
+++ b/gocardless_pro/__init__.py
@@ -2,5 +2,5 @@
 
 from .client import Client
 
-__version__ = '3.18.1'
+__version__ = '3.18.2'
 
diff --git a/gocardless_pro/api_client.py b/gocardless_pro/api_client.py
index db27f1ae..608d259f 100644
--- a/gocardless_pro/api_client.py
+++ b/gocardless_pro/api_client.py
@@ -192,7 +192,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.18.1',
+            'GoCardless-Client-Version': '3.18.2',
             'User-Agent': self._user_agent(),
             'GoCardless-Version': '2015-07-06',
         }
@@ -201,7 +201,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.18.1',
+            'gocardless-pro-python/3.18.2',
             'python/{0}'.format(python_version),
             '{0}/{1}'.format(platform.python_implementation(), vm_version),
             '{0}/{1}'.format(platform.system(), platform.release()),
diff --git a/setup.py b/setup.py
index 8756ec96..34dad13c 100644
--- a/setup.py
+++ b/setup.py
@@ -6,7 +6,7 @@
 
 setup(
     name = 'gocardless_pro',
-    version = '3.18.1',
+    version = '3.18.2',
     packages = find_packages(exclude=['tests']),
     install_requires = ['requests>=2.34.2'],
     python_requires = '>=3.6',