Feat: add affiliate to create order endpoint

[Robertbaelde]

This PR adds the ability to add Affiliate data to the create order endpoint in order to create split payments.

It requires to add PARTNER_ACCOUNT_ID to the .env.php in order to make the Functional test work.

[Robertbaelde]

@danielcivit can someone of MultisafePay look at this PR?

[danielcivit]

Hi @Robertbaelde

• First, thanks for your interest and contribution, and our apologies for not replying earlier.

• We plan to take a look at your PR in the upcoming sprints, and most probably it will be taken and merged to allow adding the affiliate information to the order request and split a payment; using an explicit method interface.

• Unfortunately, we have other priorities in our backlog, and this probably won't happen until January 2025.

• I would like to share, in case you didn't notice, how you can add this information to the order request object at this moment:

  • The UpdateRequest object extends from RequestBody object: https://github.com/MultiSafepay/php-sdk/blob/master/src/Api/Transactions/UpdateRequest.php#L16
  • The RequestBody object extends from DataObject object: https://github.com/MultiSafepay/php-sdk/blob/master/src/Api/Base/RequestBody.php#L15C7-L15C18
  • In the DataObject there is a method called addData(): https://github.com/MultiSafepay/php-sdk/blob/master/src/Api/Base/DataObject.php#L34-L43
  • Using this generic interface method, you should be able to add the affiliate property to the OrderRequest object. It will be something like this:

use MultiSafepay\Api\Transactions\OrderRequest; 

$orderRequest = new OrderRequest();

$affiliate = [
  "split_payments" => [
      [
        "merchant" => "1001001", 
        "fixed" => 100, 
        "description" => "€1 fixed-amount split" 
      ], 
      [
        "merchant" => "1001002", 
        "percentage" => 20, 
        "description" => "20% split" 
      ] 
    ] 
];

$orderRequest->addData( 
  array( 'affiliate' => $affiliate ) 
);

• Just to be clear, we fully agree that a better approach will be adding an explicit interface to provide support for such property of the order request; like your PR suggests. We are just sharing this to let you know this approach could be something that you can immediately adopt without the need to fork the SDK; while we find the time to work on this new feature.

We will get back to you in the upcoming days to provide you an update; and once again, thank you for your contribution.