Allowing Address to be optional when creating a new payment recipient.

Updating Docblocks on createRecipient method to better explain the $account parameter.

Author: brentscheffler

src/Resources/Payments.php

@@ -13,18 +13,21 @@ class Payments extends AbstractResource
 	 * Create a recipient request for payment initiation.
 	 *
 	 * @param string $name
-	 * @param BacsAccount|string $account
-	 * @param RecipientAddress $address
+	 * @param BacsAccount|string $account Bacs account or IBAN.
+	 * @param RecipientAddress|null $address
 	 * @throws PlaidRequestException
 	 * @return object
 	 */
-	public function createRecipient(string $name, $account, RecipientAddress $address): object
+	public function createRecipient(string $name, $account, ?RecipientAddress $address = null): object
 	{
 		$params = [
-			"name" => $name,
-			"address" => (object) $address->toArray()
+			"name" => $name
 		];
 
+		if( $address ) {
+			$params["address"] = (object) $address->toArray();
+		}
+
 		if( \is_string($account) ){
 			$params["iban"] = $account;
 		}

tests/PaymentsTest.php

@@ -44,6 +44,24 @@ public function test_create_recipient(): void
 		);
 	}
 
+	public function test_create_recipient_with_no_address(): void
+	{
+		$response = $this->getPlaidClient()->payments->createRecipient(
+			"name",
+			"iban"
+		);
+
+		$this->assertEquals("POST", $response->method);
+		$this->assertEquals("2020-09-14", $response->version);
+		$this->assertEquals("application/json", $response->content);
+		$this->assertEquals("/payment_initiation/recipient/create", $response->path);
+		$this->assertEquals("client_id", $response->params->client_id);
+		$this->assertEquals("secret", $response->params->secret);
+		$this->assertEquals("name", $response->params->name);
+		$this->assertEquals("iban", $response->params->iban);
+		$this->assertFalse(isset($response->params->address));
+	}
+
 	public function test_create_recipient_with_bacs_account_entity(): void
 	{
 		$response = $this->getPlaidClient()->payments->createRecipient(