Square APIを使って自社ECサイトに決済機能を実装しました。
Square APIの導入、サンプルの実装については@goofmintさんのPHPでSquare Eコマース決済を試すを参考にしました。

サンプルでは金額を指定したリクエストを作成し、Transactions API の Charge を実行して決済を行いました。


\SquareConnect\Configuration::getDefaultConfiguration()->setAccessToken($access_token);
$transactions_api = new \SquareConnect\Api\TransactionsApi();

//リクエストを作成
$request_body = array (
  "card_nonce" => $nonce,
  "amount_money" => array (
    "amount" => 100,
    "currency" => "JPY"
  ),
  "idempotency_key" => uniqid()
);

try {
  //決済実行
  $result = $transactions_api->charge($location_id, $request_body);
} catch (\SquareConnect\ApiException $e) {
  echo "Caught exception!<br/>";
  $result = $e->getResponseBody();		
}

今回、Squareダッシュボードであらかじめ登録されている商品に対して決済を実行することにより
ダッシュボード上で在庫の管理や上位売上商品のチェックなどができるようにします。

##　商品に対する決済を実行する流れ
サンプルで使用している Transactions API、 Locations APIに加えて、
Catalog API、 Orders APIを使って決済を実行していきます。

Squareダッシュボード上で商品を登録
Catalog API の SearchCatalogObjectsRequest を実行して商品リストを取得
CreateOrderRequestLineItem を作成
Order API の createOrder を実行
Order Idを指定して Transactions API のChargeを実行

商品は登録されていることを前提に、2からの実装を見ていきます。

##　2. Catalog APIで商品リストを取得

Catalog APIのオブジェクトを作成し、SearchCatalogObjectRequestを実行します。
ここで1点ハマるポイントが、現時点でCatalog APIはsandbox環境での動作に対応していません。
なのでこのテストを行う際には各環境IDは本番のものを使用してください。
5のChargeまで実行すると当然ですがカードに対し課金が行われてしまうため、
テスト後にSquareダッシュボードより売上の払い戻しを行ってください。


$catalog_api = new SquareConnect\Api\CatalogApi();
$body = new \SquareConnect\Model\SearchCatalogObjectsRequest();

try {
    $result = $catalog_api->searchCatalogObjects($body);
    echo "<pre>";
    print_r($result);
    echo "</pre>";
} catch (Exception $e) {
    echo 'Exception when calling CatalogApi->searchCatalogObjects: ', $e->getMessage(), PHP_EOL;
}

登録商品リスト(SearchCatalogObjectsResponse Object)が取得できました。
※ 空の項目が非常に多いため今回重要ではない部分について一部略しています

##　3.CreateOrderRequestLineItem を作成
Orders APIにリクエストするための商品（LineItem）を作成します。
2 で取得したSearchCatalogObjectsResponse Objectのvaridations内のidを抽出し、
CreateOrderRequestLineItemにid、個数をセットし、arrayに格納します。
購入する商品が複数ある場合はここで追加していくことになります。


$item_id = $result['objects'][0]['item_data']['variations'][0][id];
$item = new \SquareConnect\Model\CreateOrderRequestLineItem;
$item->setCatalogObjectId($item_id);
$item->setQuantity('1');

$lineItems = array();	
array_push($lineItems, $item);

##　4.Order API の createOrder を実行
3で作成したLineItemsとuniqid()を設定したCreateOrderRequestを作成して、
Orders APIの createOrder を実行します。

$orders_api = new SquareConnect\Api\OrdersApi();
$request = new \SquareConnect\Model\CreateOrderRequest();
$request->setIdempotencyKey(uniqid());
$request->setLineItems($lineItems);
	
try {
    $result = $orders_api->createOrder($location_id, $request);

}catch (Exception $e) {
    echo '<pre>';
    echo 'Exception when calling OrdersApi->createOrder:', $e->getMessage(), PHP_EOL;
}

これで商品を指定したオーダーが作成されました。
CreateOrderResponseは以下のようになります。(一部省略)

SquareConnect\Model\CreateOrderResponse Object
(
    [order:protected] => SquareConnect\Model\Order Object
    (
    　   [id:protected] => WBOP7aUfNxFGuSZk8wsgmswFsVHZY
         [location_id:protected] => 325X8D9WZ2239
         [reference_id:protected] => 
         [line_items:protected] => Array
         (
             [0] => SquareConnect\Model\OrderLineItem Object
             (
                 [name:protected] => 塩バターパン
                 [quantity:protected] => 1
                 [note:protected] => 
                 [catalog_object_id:protected] => QBORT2E36FKXPNLY42EMWPBA
                 [variation_name:protected] => 販売価格
               　・・・(略)・・・
                 [total_money:protected] => SquareConnect\Model\Money Object
                 (
                     [amount:protected] => 160
                     [currency:protected] => JPY
                 )
            )
      )
     [total_money:protected] => SquareConnect\Model\Money Object
     (
         [amount:protected] => 160
         [currency:protected] => JPY
     )
     ・・・(略)・・・
  )
    [errors:protected] => 
)

5. Order Idを指定して Transactions API のChargeを実行

4のレスポンスからChargeRequestに指定するためのOrder Idとtotal_moneyを抽出し、
ChargeRequestを作成します。サンプルでは$request_bodyとしてarrayを直接作成していましたが、
今回はそれぞれ値をsetして作成しています。

$order_id = $result['order']['id'];
$amount_money = $result['order']['total_money']; 
		
$chargeRequest = new \SquareConnect\Model\ChargeRequest();
$chargeRequest->setIdempotencyKey(uniqid());
$chargeRequest->setAmountMoney($amount_money);
$chargeRequest->setCardNonce($nonce);
$chargeRequest->setOrderId($order_id);

try {
    $result = $transactions_api->charge($location_id, $chargeRequest);

} catch (\SquareConnect\ApiException $e) {
    echo "Caught exception!<br/>";
    print_r("<strong>Response body:</strong><br/>");
    echo "<pre>"; var_dump($e->getResponseBody()); echo "</pre>";
    echo "<br/><strong>Response headers:</strong><br/>";
    echo "<pre>"; var_dump($e->getResponseHeaders()); echo "</pre>";
}

chargeが正常に行われると以下のようなレスポンスが返ってきます。
order_idに正しく設定されていることが確認できます。

Squareダッシュボード上でも商品に対する売上が反映されていることが確認できました。

おわりに

まだまだ日本語の文献が少なく、Stack Overflowで検索したり、リファレンスを翻訳しながら読み進めて実装しました。質問はもちろん間違いなどありましたらコメントを頂けますと幸いです。