OctopusDeploy release: 8.0.2

CHANGELOG.md

@@ -5,6 +5,14 @@
 # Changelog
 
 ## Latest Version
+#### Enhancements:
+- Profac: Additional transaction support added | Account Management | Spilt Fund | Network Transaction
+- PAX Devices: Improved some tests
+
+#### Bug Fixes:
+- GP-ECOM: Fix type confusion vulnerability on sha1hash for hppResponse
+
+## v8.0.1 (05/30/2023)
 #### Bug Fixes:
 - Portico/Heartland: fix 'AllowDup' flag not included with some CreditReturn transactions
 

metadata.xml

@@ -1,3 +1,3 @@
 <xml>
-  <releaseNumber>8.0.1</releaseNumber>
+  <releaseNumber>8.0.2</releaseNumber>
 </xml>

src/Builders/PayFacBuilder.php

@@ -1,9 +1,9 @@
 <?php
+
 namespace GlobalPayments\Api\Builders;
 
 use GlobalPayments\Api\Entities\Address;
 use GlobalPayments\Api\Entities\AddressCollection;
-use GlobalPayments\Api\Entities\Customer;
 use GlobalPayments\Api\Entities\Enums\AddressType;
 use GlobalPayments\Api\Entities\Enums\PaymentMethodFunction;
 use GlobalPayments\Api\Entities\Enums\StatusChangeReason;
@@ -40,6 +40,7 @@ class PayFacBuilder extends BaseBuilder
      * @var BankAccountData
      */
     public $achInformation;
+    public $mailingAddressInformation;
     public $secondaryBankInformation;
     public $grossBillingInformation;
     public $accountNumber;
@@ -59,8 +60,23 @@ class PayFacBuilder extends BaseBuilder
     public $externalId;
     public $sourceEmail;
     public $deviceDetails;
+    public $deviceData;
+
     /** @var string */
     public $description;
+
+    /** @var string */
+    public $gatewayTransactionId;
+
+    /** @var string */
+    public $globaltransId;
+
+    /** @var string */
+    public $globalTransSource;
+
+    /** @var string */
+    public $cardBrandTransactionId;
+
     /**
      * @var array<Product>
      */
@@ -105,6 +121,15 @@ class PayFacBuilder extends BaseBuilder
     /** @var AddressCollection */
     public $addresses;
 
+    /**
+     * Required for partners ordering Portico devices. Valid values:
+     * [ UTC, PT, MST, MT, CT, ET, HST, AT, AST, AKST, ACT, EET, EAT, MET, NET, PLT,
+     * IST, BST, VST, CTT, JST, ACT, AET, SST, NST, MIT, CNT, AGT, CAT]
+     *
+     * @var string
+     */
+    public $timezone;
+
     const UPLOAD_FILE_TYPES = [
         'tif', 'tiff', 'bmp', 'jpg', 'jpeg', 'gif', 'png', 'doc', 'docx'
     ];
@@ -134,11 +159,9 @@ public function execute($configName = 'default')
     {
         parent::execute($configName);
         $client = ServicesContainer::instance()->getPayFac($configName);
-        if (
-            method_exists($client, "hasBuiltInMerchantManagementService") &&
-            $client->hasBuiltInMerchantManagementService()
-        ) {
-            return $client->processBoardingUser($this);
+        if (method_exists($client, "hasBuiltInMerchantManagementService")
+            && $client->hasBuiltInMerchantManagementService()) {
+             return $client->processBoardingUser($this);
         }
 
         return $client->processPayFac($this);
@@ -246,7 +269,8 @@ protected function setupValidations()
 
         $this->validations->of(TransactionType::SPLIT_FUNDS)
                 ->with(TransactionModifier::NONE)
-                ->check('transNum')->isNotNull()
+                ->check('accountNumber')->isNotNull()
+                ->check('amount')->isNotNull()
                 ->check('receivingAccountNumber')->isNotNull();
 
         $this->validations->of(TransactionType::REVERSE_SPLITPAY)
@@ -274,7 +298,7 @@ protected function setupValidations()
      *
      * var Object GlobalPayments\Api\Entities\PayFac\BankAccountData;
      */
-    public function withBankAccountData(BankAccountData $bankAccountData, $paymentMethodFunction =  null)
+    public function withBankAccountData(BankAccountData $bankAccountData, $paymentMethodFunction = null)
     {
         $this->bankAccountData = $bankAccountData;
         if (!empty($paymentMethodFunction)) {
@@ -336,7 +360,7 @@ public function withUserPersonalData(UserPersonalData $userPersonalData)
         return $this;
     }
 
-    public function withCreditCardData($creditCardInformation, $paymentMethodFunction =  null)
+    public function withCreditCardData($creditCardInformation, $paymentMethodFunction = null)
     {
         $this->creditCardInformation = $creditCardInformation;
         if (!empty($paymentMethodFunction)) {
@@ -352,7 +376,13 @@ public function withACHData($achInformation)
         $this->achInformation = $achInformation;
         return $this;
     }
-
+
+    public function withMailingAddress($mailingAddressInformation)
+    {
+        $this->mailingAddressInformation = $mailingAddressInformation;
+        return $this;
+    }
+
     public function withSecondaryBankAccountData($secondaryBankInformation)
     {
         $this->secondaryBankInformation = $secondaryBankInformation;
@@ -413,7 +443,7 @@ public function withRenewalAccountData($renewalAccountData)
 
     /*
      * Document details
-     * 
+     *
      * var GlobalPayments\Api\Entities\PayFac\UploadDocumentData
      */
     public function withUploadDocumentData($uploadDocumentData)
@@ -463,7 +493,7 @@ public function withCCAmount($ccAmount)
         $this->ccAmount = $ccAmount;
         return $this;
     }
-    
+
     public function withRequireCCRefund($requireCCRefund)
     {
         $this->requireCCRefund = $requireCCRefund;
@@ -493,13 +523,43 @@ public function withSourceEmail($sourceEmail)
         $this->sourceEmail = $sourceEmail;
         return $this;
     }
-
+
+    public function withGatewayTransactionId($gatewayTransactionId)
+    {
+        $this->gatewayTransactionId = $gatewayTransactionId;
+        return $this;
+    }
+
+    public function withGlobaltransId($globaltransId)
+    {
+        $this->globaltransId = $globaltransId;
+        return $this;
+    }
+
+    public function withGlobalTransSource($globalTransSource)
+    {
+        $this->globalTransSource = $globalTransSource;
+        return $this;
+    }
+
+    public function withCardBrandTransactionId($cardBrandTransactionId)
+    {
+        $this->cardBrandTransactionId = $cardBrandTransactionId;
+        return $this;
+    }
+
     public function withDeviceDetails($deviceDetails)
     {
         $this->deviceDetails = $deviceDetails;
         return $this;
     }
 
+    public function withDeviceData($deviceData)
+    {
+        $this->deviceData = $deviceData;
+        return $this;
+    }
+
     public function withDescription($description)
     {
         $this->description = $description;
@@ -586,4 +646,10 @@ public function withAddress(Address $address, $type = AddressType::BILLING)
 
         return $this;
     }
+
+    public function withTimeZone($timezone)
+    {
+        $this->timezone = $timezone;
+        return $this;
+    }
 }

src/Entities/Address.php

@@ -69,6 +69,13 @@ class Address
      */
     public $postalCode;
 
+    /**
+     * Consumer's phone.
+     *
+     * @var string
+     */
+    public $phone;
+
     /**
      * Consumer's country.
      *

src/Entities/Enums/TransactionType.php

@@ -57,12 +57,13 @@ class TransactionType extends Enum
     const REVERSE_SPLITPAY = 281474976710656; //1 << 48;
     const SPLIT_FUNDS = 562949953421312; //1 << 49;
     const GET_ACCOUNT_DETAILS = 1125899906842624; //1 << 50;
-    const GET_ACCOUNT_BALANCE = 2251799813685248; //1 << 51;    
+    const GET_ACCOUNT_BALANCE = 2251799813685248; //1 << 51;
     const DETOKENIZE = 4503599627370496; //1 << 52
     const DISPUTE_ACCEPTANCE = 9007199254740992; // 1 << 53
     const DISPUTE_CHALLENGE = 18014398509481984; // 1 << 54
     const REAUTH = 36028797018963968; // 1 << 55
     const CONFIRM = 72057594037927936; // 1 << 56
     const PAYLINK_UPDATE = 144115188075855872; // 1 << 57
-    const TRANSFER_FUNDS = 288230376151711744; // // 1 << 58
+    const TRANSFER_FUNDS = 288230376151711744; // 1 << 58
+    const DEVICE_ORDER = 576460752303423488; // 1 << 59
 }

src/Entities/PayFac/BusinessData.php

@@ -15,8 +15,8 @@ class BusinessData
 
     /**
      * This field can be used to provide DBA information on an account. ProPay accounts can be
-       configured to display DBA on cc statements. (Note most banks' CC statements allow for 29
-       characters so 255 max length is not advised.)
+     * configured to display DBA on cc statements. (Note most banks' CC statements allow for 29
+     *  characters so 255 max length is not advised.)
      *
      * @var string
      */
@@ -80,8 +80,13 @@ class BusinessData
      * @var GlobalPayments\Api\Entities\Address
      */
     public $businessAddress;
-
-
+
+    /* Business Type
+     *
+     * @var string
+     */
+    public $businessType;
+
     public function __construct()
     {
         $this->businessAddress = new Address();

src/Entities/PayFac/DeviceAttributeInfo.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace GlobalPayments\Api\Entities\PayFac;
+
+class DeviceAttributeInfo
+{
+    /**
+     * Name of attribute item which is specific to Portico devices for AMD.
+     * The value of this item is passed to Heartland for
+     * equipment boarding.
+     *
+     * @var string
+     */
+    public $name;
+
+    /**
+     * Value of the attribute item.
+     *
+     * @var string
+     */
+    public $value;
+}

src/Entities/PayFac/DeviceDetails.php

@@ -2,8 +2,31 @@
 
 namespace GlobalPayments\Api\Entities\PayFac;
 
-class DeviceDetails
+use ArrayObject;
+use GlobalPayments\Api\Entities\Exceptions\ArgumentException;
+
+class DeviceDetails extends \ArrayObject
 {
     public $quantity;
     public $timezone;
+    public $name;
+    public $attributes;
+
+    public function __construct()
+    {
+        $this->attributes = new DeviceAttributeInfo();
+    }
+
+    /**
+     * @param DeviceDetails $value
+     *
+     * @return void
+     */
+    public function append($value) : void
+    {
+        if (!$value instanceof DeviceDetails) {
+            throw new ArgumentException("Invalid argument type");
+        }
+        parent::append($value);
+    }
 }

src/Entities/PayFac/DeviceOrder.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace GlobalPayments\Api\Entities\PayFac;
+
+class DeviceOrder
+{
+    public $accountNumber;
+    public $shipTo;
+    public $shipToContact;
+    public $shipToAddress;
+    public $shipToAddress2;
+    public $shipToCity;
+    public $shipToState;
+    public $shipToZip;
+    public $shipToPhone;
+    public $cardholderName;
+    public $ccNum;
+    public $expDate;
+    public $cvv2;
+    public $billingZip;
+    public $name;
+    public $quantity;
+}