[PWTS-38] Add business APIs

code-samples/business/address.php

@@ -0,0 +1,76 @@
+<?php
+
+require_once('../../lib/autoload.php');
+
+$businessGateway = new FasterPay\BusinessGateway([
+    'publicKey' => '<your-public-key>',
+    'privateKey' => '<your-private-key>',
+]);
+
+echo "FasterPay Address API Examples\n";
+echo "==============================\n\n";
+
+// Example 1: Get address fields for United States
+echo "1. Getting address fields for United States\n";
+echo "--------------------------------------------\n";
+
+try {
+    $addressFieldsResponse = $businessGateway->addressService()->getAddressFields('US');
+
+    if ($addressFieldsResponse->isSuccessful()) {
+        echo "Address fields retrieved successfully\n";
+        $data = $addressFieldsResponse->getDecodeResponse();
+        $countryCode = isset($data['data']['country_code']) ? $data['data']['country_code'] : 'US';
+        $fields = isset($data['data']['fields']) ? $data['data']['fields'] : [];
+        $subdivisions = isset($data['data']['subdivisions']) ? $data['data']['subdivisions'] : [];
+
+        echo "  Country: $countryCode\n";
+        echo "  Required fields:\n";
+
+        foreach ($fields as $field) {
+            $type = isset($field['type']) ? $field['type'] : 'text';
+            $label = isset($field['label']) ? $field['label'] : '';
+            $name = isset($field['name']) ? $field['name'] : '';
+            echo "    - $label ($name): $type\n";
+        }
+
+        echo "  States/subdivisions: " . count($subdivisions) . " available\n";
+        echo "  Example states: ";
+        $exampleStates = array_slice($subdivisions, 0, 3);
+        foreach ($exampleStates as $state) {
+            echo $state['name'] . ' (' . $state['code'] . ') ';
+        }
+        echo "\n";
+    } else {
+        echo "Error: " . $addressFieldsResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 2: Get address fields for Canada
+echo "2. Getting address fields for Canada\n";
+echo "------------------------------------\n";
+
+try {
+    $canadaFieldsResponse = $businessGateway->addressService()->getAddressFields('CA');
+
+    if ($canadaFieldsResponse->isSuccessful()) {
+        echo "Canadian address fields retrieved\n";
+        $data = $canadaFieldsResponse->getDecodeResponse();
+        $fields = isset($data['data']['fields']) ? $data['data']['fields'] : [];
+
+        echo "  Canada requires " . count($fields) . " fields:\n";
+        foreach ($fields as $field) {
+            echo "    - " . (isset($field['label']) ? $field['label'] : 'Unknown') . "\n";
+        }
+    } else {
+        echo "Error: " . $canadaFieldsResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\nAddress API examples completed!\n";

code-samples/business/contact.php

@@ -0,0 +1,193 @@
+<?php
+
+require_once('../../lib/autoload.php');
+
+$businessGateway = new FasterPay\BusinessGateway([
+    'publicKey' => '<your-public-key>',
+    'privateKey' => '<your-private-key>',
+]);
+
+echo "FasterPay Contact API Examples\n";
+echo "===============================\n\n";
+
+// Example 1: Create a new individual contact
+echo "1. Creating a new individual contact\n";
+echo "------------------------------------\n";
+
+$contactData = [
+    'email' => 'john.smith@example.com',
+    'phone' => '2015550124',
+    'phone_country_code' => 'US',
+    'first_name' => 'John',
+    'last_name' => 'Smith',
+    'country' => 'US',
+    'favorite' => true
+];
+
+try {
+    $contactResponse = $businessGateway->contactService()->createContact($contactData);
+
+    if ($contactResponse->isSuccessful()) {
+        echo "Contact created successfully\n";
+        $responseData = $contactResponse->getDecodeResponse();
+        $contactId = isset($responseData['data']['id']) ? $responseData['data']['id'] : 'CT-' . time();
+        echo "  Contact ID: " . $contactId . "\n";
+        echo "  Name: " . $contactData['first_name'] . " " . $contactData['last_name'] . "\n";
+        echo "  Email: " . $contactData['email'] . "\n";
+        echo "  Phone: " . $contactData['phone'] . "\n";
+        echo "  Country: " . $contactData['country'] . "\n";
+    } else {
+        echo "Error: " . $contactResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 2: Create another contact (for listing)
+echo "2. Creating another contact (for listing)\n";
+echo "---------------------------\n";
+
+$secondContactData = [
+    'email' => 'jane.doe@example.com',
+    'phone' => '2015550987',
+    'phone_country_code' => 'US',
+    'first_name' => 'Jane',
+    'last_name' => 'Doe',
+    'country' => 'US',
+    'favorite' => false
+];
+
+try {
+    $secondContactResponse = $businessGateway->contactService()->createContact($secondContactData);
+
+    if ($secondContactResponse->isSuccessful()) {
+        echo "Second contact created successfully\n";
+        $responseData = $secondContactResponse->getDecodeResponse();
+        $secondContactId = isset($responseData['data']['id']) ? $responseData['data']['id'] : 'CT-2-' . time();
+        echo "  Contact ID: " . $secondContactId . "\n";
+        echo "  Name: " . $secondContactData['first_name'] . " " . $secondContactData['last_name'] . "\n";
+        echo "  Email: " . $secondContactData['email'] . "\n";
+        echo "  Phone: " . $secondContactData['phone'] . "\n";
+    } else {
+        echo "Error: " . $secondContactResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 3: Get contact details
+echo "3. Getting contact details\n";
+echo "--------------------------\n";
+
+try {
+    $detailsResponse = $businessGateway->contactService()->getContact($contactId);
+
+    if ($detailsResponse->isSuccessful()) {
+        echo "Contact details retrieved successfully\n";
+        $details = $detailsResponse->getDecodeResponse();
+
+        if (isset($details['data'])) {
+            $contact = $details['data'];
+            echo "  ID: " . (isset($contact['id']) ? $contact['id'] : 'N/A') . "\n";
+            echo "  Name: " . (isset($contact['first_name']) ? $contact['first_name'] : '') . " " . (isset($contact['last_name']) ? $contact['last_name'] : '') . "\n";
+            echo "  Email: " . (isset($contact['email']) ? $contact['email'] : 'N/A') . "\n";
+            echo "  Phone: " . (isset($contact['phone_full_number']) ? $contact['phone_full_number'] : 'N/A') . "\n";
+            echo "  Country: " . (isset($contact['country']) ? $contact['country'] : 'N/A') . "\n";
+        }
+    } else {
+        echo "Error: " . $detailsResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 4: Update contact
+echo "4. Updating contact information\n";
+echo "-------------------------------\n";
+
+$updateData = [
+    'phone' => '2015550125',
+    'phone_country_code' => 'US',
+    'favorite' => false,
+    'first_name' => 'Jonathan'
+];
+
+try {
+    $updateResponse = $businessGateway->contactService()->updateContact($contactId, $updateData);
+
+    if ($updateResponse->isSuccessful()) {
+        echo "Contact updated successfully\n";
+        echo "  Contact ID: " . $contactId . "\n";
+        echo "  New phone: " . $updateData['phone'] . "\n";
+        echo "  Updated name: " . $updateData['first_name'] . "\n";
+        echo "  Favorite: " . ($updateData['favorite'] ? 'Yes' : 'No') . "\n";
+    } else {
+        echo "Error: " . $updateResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 5: List contacts with filters
+echo "5. Listing contacts with filters\n";
+echo "--------------------------------\n";
+
+$filters = [
+    'per_page' => 20,
+    'page' => 1
+];
+
+try {
+    $listResponse = $businessGateway->contactService()->listContacts($filters);
+
+    if ($listResponse->isSuccessful()) {
+        echo "Contact list retrieved successfully\n";
+
+        $listData = $listResponse->getDecodeResponse();
+        if (isset($listData['data']['data']) && is_array($listData['data']['data'])) {
+            $contacts = $listData['data']['data'];
+            echo "  Found " . count($contacts) . " contacts\n";
+
+            foreach ($contacts as $contact) {
+                $name = (isset($contact['first_name']) ? $contact['first_name'] : '') . ' ' . (isset($contact['last_name']) ? $contact['last_name'] : '');
+                $email = isset($contact['email']) ? $contact['email'] : 'No email';
+                echo "    - " . trim($name) . " (" . $email . ")\n";
+            }
+        }
+    } else {
+        echo "Error: " . $listResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\n";
+
+// Example 6: Delete a contact
+echo "6. Deleting a contact\n";
+echo "---------------------\n";
+
+$contactToDelete = isset($secondContactId) ? $secondContactId : 'CT-DELETE-' . time();
+
+try {
+    $deleteResponse = $businessGateway->contactService()->deleteContact($contactToDelete);
+
+    if ($deleteResponse->isSuccessful()) {
+        echo "Contact deleted successfully\n";
+        echo "  Deleted Contact ID: " . $contactToDelete . "\n";
+    } else {
+        echo "Error: " . $deleteResponse->getErrors()->getMessage() . "\n";
+    }
+} catch (FasterPay\Exception $e) {
+    echo "Exception: " . $e->getMessage() . "\n";
+}
+
+echo "\nContact API examples completed!\n";