Finish 1.5.0

jmauzyk · Apr 21, 2021 · ca8ed45 · ca8ed45
1 parent 5fd34ae
commit ca8ed45
Show file tree

Hide file tree

Showing 2 changed files with 36 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Release Notes for CardConnect for Craft Commerce
 
+## 1.5.0 - 2021-04-20
+### Added
+* Added `UserFieldsEvent` for sending custom data with authorizations ([documentation](https://github.com/jmauzyk/commerce-cardconnect#custom-user-fields))
+
+### Changed
+* The plugin now supports Commerce Omnipay 3.0
+* The plugin now requires Omnipay: CardConnect 1.4.0
+
+### Fixed
+* Fixed a bug where purchase transactions failed to validate correctly
+* Fixed a bug where requests failed to send cardholder name if different from billing address
+* Fixed a bug where requests using payment sources failed to populate cardholder name
+
 ## 1.4.4 - 2020-12-17
 ### Fixed
 * Fixed bug where expiry pattern wouldn't validate correctly in certain instances

diff --git a/README.md b/README.md
@@ -161,3 +161,26 @@ Below is an example of how you can customize the default payment form and tokeni
 {# To output tokenized number input with customization... #}
 {{ gateway.getIframeNumberInput(srcParams, options)|raw }}
 ```
+
+## Custom User Fields
+
+The CardPointe Gateway API supports custom [user fields](https://developer.cardpointe.com/cardconnect-api#additional-optional-fields) in authorization requests that can be recalled later. These custom values can be populated using the `UserFieldsEvent`:
+
+```php
+use jmauzyk\commerce\cardconnect\events\UserFieldsEvent;
+use jmauzyk\commerce\cardconnect\gateways\Gateway;
+use yii\base\Event;
+
+Event::on(
+    Gateway::class,
+    Gateway::USER_FIELDS_EVENT,
+    function (UserFieldsEvent $e) {
+        $order = $e->order;
+
+        $e->userFields = [
+            'note' => $order->note ?? '',
+            // ...
+        ];
+    }
+);
+```