在開發一個電商平臺時，我遇到了一個棘手的問題：如何高效地管理支付流程，包括處理支付、管理客戶和庫存等。最初，我嘗試使用自定義的支付解決方案，但發現這不僅增加了開發時間，還容易出錯。最終，我找到了square api，它通過其php庫提供了便捷的解決方案，極大地簡化了我的工作。
Square API是一個強大的工具，允許開發者通過其PHP庫來管理和運行業務，包括支付、客戶、產品、庫存和員工管理。使用Square API的PHP庫，你可以輕松地集成這些功能到你的項目中。
首先，你需要確保你的環境滿足以下要求：
- PHP 8.1 或更高版本
安裝Square PHP SDK非常簡單，只需使用composer：
composer require square/square
接下來，你可以開始使用Square API來處理支付。例如，創建一個支付請求：
立即學習“PHP免費學習筆記（深入）”；
use SquareSquareClient; use SquarePaymentsRequestsCreatePaymentRequest; use SquareTypesCashPaymentDetails; use SquareTypesCurrency; use SquareTypesMoney; $square = new SquareClient(); $response = $square->payments->create( request: new CreatePaymentRequest( [ 'idempotencyKey' => '4935a656-a929-4792-b97c-8848be85c27c', 'sourceId' => 'CASH', 'amountMoney' => new Money([ 'amount' => 100, 'currency' => Currency::Usd->value ]), 'tipMoney' => new Money([ 'amount' => 50, 'currency' => Currency::Usd->value ]), 'cashDetails' => new CashPaymentDetails([ 'buyerSuppliedMoney' => new Money([ 'amount' => 200, 'currency' => Currency::Usd->value ]) ]), ], ) );
要使用Square SDK，你需要實例化SquareClient類：
use SquareSquareClient; $square = new SquareClient("SQUARE_Token");
如果你沒有在代碼中指定token，SDK會自動從SQUARE_TOKEN環境變量中讀取：
use SquareSquareClient; $square = new SquareClient(); // Token is read from the SQUARE_TOKEN environment variable.
Square SDK還支持配置不同的環境或自定義URL：
use SquareSquareClient; use SquareEnvironments; $square = new SquareClient(options: [ 'baseUrl' => Environments::Production->value // Used by default ]);
或者使用自定義URL：
use SquareSquareClient; $square = new SquareClient(options: [ 'baseUrl' => 'https://custom-staging.com' ]);
Square SDK利用PHP 8.1的枚舉類型來提高類型安全性和可用性。例如：
use SquareTypesInvoicePaymentRequest; use SquareTypesInvoiceRequestType; $paymentRequest = new InvoicePaymentRequest([ 'requestType' => InvoiceRequestType::Balance->value, ... ]);
對于列表端點，SDK提供了自動分頁功能，允許你輕松遍歷項目：
use SquarePaymentsRequestsListPaymentsRequest; $payments = $square->payments->list( new ListPaymentsRequest([ 'total' => 100, ]), ); foreach ($payments as $payment) { echo sprintf( "payment: ID: %s Created at: %s, Updated at: %sn", $payment->getId(), $payment->getCreatedAt(), $payment->getUpdatedAt(), ); }
你還可以設置請求超時時間：
$payments = $square->payments->list( request: new ListPaymentsRequest([ 'total' => 100, ]), options: [ 'timeout' => 1.0, ], );
當API返回非零狀態碼時，SDK會拋出SquareApiException，你可以捕獲并處理這些異常：
use SquareExceptionsSquareApiException; use SquareExceptionsSquareException; try { $square->payments->create(...); } catch (SquareApiException $e) { echo 'Square API Exception occurred: ' . $e->getMessage() . "n"; echo 'Status Code: ' . $e->getCode() . "n"; echo 'Response Body: ' . $e->getBody() . "n"; // Optionally, rethrow the exception or handle accordingly. }
Square SDK還提供了驗證Webhook簽名的工具方法，確保所有Webhook事件都來自Square：
use SquareUtilsWebhooksHelper; $isValid = WebhooksHelper.verifySignature( requestBody: $requestBody, signatureHeader: $headers['x-square-hmacsha256-signature'], signatureKey: 'YOUR_SIGNATURE_KEY', notificationUrl: 'https://example.com/webhook', // The URL where event notifications are sent. )
如果你正在使用舊版SDK，可以通過SquareLegacy…來訪問：
use SquareSquareClient; use SquareLegacySquareClient as LegacySquareClient; $square = new SquareClient(); $legacyClient = new LegacySquareClient();
最后，Square SDK支持自定義HTTP客戶端和發送額外的請求參數，這使得它更加靈活和強大。
使用Square API和其PHP庫，我成功地簡化了支付系統的開發過程，提高了項目的整體效率和可靠性。如果你也面臨類似的挑戰，強烈推薦嘗試Square API。
