2件
2026-05-29
Square
POS連携
データマッピング
技術詳細
取引データ
API
Square 取引データとレシートローラー取引データのマッピング
Square Payment API から取得した取引データを、レシートローラーの取引データモデルにマッピングする仕組みの技術解説です。フィールド単位の対応表、ステータスコードの変換、支払い方法の正規化、明細・顧客・スタッフ情報の解決、OAuth トークンの自動リフレッシュ、Webhook と手動同期の違い、冪等性とタイムゾーンの扱いなど、内部仕様を理解したい開発者・運用担当者向けに整理しています。
2026-05-29
Square
顧客
Customer Directory
POS連携
データマッピング
Square 顧客データとレシートローラー顧客データのマッピング
Square Customer Directory がレシートローラーの顧客データ（CrmCustomerDto）にどう変換されるかをフィールド単位で説明します。given_name / family_name の対応、住所の分解ロジック、reference_id の扱いまでまとめています。