Square決済
カード決済、決済完了後のDB更新、完了画面表示を実装します。
Square決済は、申込、予約、注文、月額プランなどの支払いをカードで受け付け、決済結果を業務データへ反映する機能です。Roundtableでは「いつ決済するか」「何を支払い対象にするか」「成功時と失敗時にどの状態へ進めるか」を先にそろえると、発注者、実装者、AIに指示する人が同じ前提で支払い導線を設計できます。
この機能でできること
公開ページや管理画面からカード決済を実行し、支払いが成功したら対象レコードの入金状態、決済日時、決済ID、次に表示する完了画面を更新できます。申込受付、予約確定、チケット購入、会費支払い、追加オプション購入など、支払い完了をきっかけに業務を次へ進める導線を作れます。
支払い操作と業務データの更新をひとつの流れにします。
決済画面だけでなく、決済前の確認、成功時のDB更新、失敗時の再試行、完了画面、通知までをセットで決めると運用後の抜けを減らせます。
よくある利用場面
申込や予約の支払いを受け付ける
公開フォームで入力内容を確認した後にカード決済へ進み、成功したら申込済み、予約確定、入金済みにします。
追加料金やオプションを決済する
既存の案件、注文、会員情報に対して、追加作業費、延長料金、オプション料金だけを支払い対象にします。
完了後の案内や通知につなげる
支払い完了画面で受付番号や次の手順を表示し、担当者通知、顧客メール、帳票作成へつなげます。
プロンプト例
決済対象、金額の決め方、成功時の更新項目、失敗時の扱い、完了画面、通知、テスト時の確認方法をまとめて伝えると、実装範囲を決めやすくなります。
プロンプト
イベント申込の公開ページにSquare決済を追加してください。申込内容確認後にカード決済を行い、成功したら申込レコードの状態を入金済みにし、決済ID、決済日時、決済金額を保存してください。完了画面には受付番号、申込者名、支払金額、当日の案内を表示し、担当者へ通知メールを送ってください。決済失敗時は申込内容を保持したまま、再決済できる画面に戻してください。
この機能を使うときのポイント
決済対象申込、予約、注文、会員プラン、追加料金など、どのレコードを支払い対象にするかを決めます。
金額の確定タイミング入力内容、割引、税、手数料、数量が変わる場合は、決済直前にサーバー側で金額を再計算します。
成功後の状態更新入金済み、予約確定、利用開始、通知済みなど、決済成功後に更新する項目を明確にします。
失敗と二重決済の扱い失敗時の再試行、戻り先、同じ申込で複数回決済されない制御、決済済みレコードの再実行禁止を決めます。
この機能を実装するときのコツ
決済処理では、画面から送られた金額をそのまま信用せず、対象レコードと料金ルールからサーバー側で金額を確定します。決済前は未決済または決済待ち、成功後は入金済み、失敗時は再決済可能な状態として、状態遷移を明確にします。FBPではSquare決済用の標準処理やコールバックを使い、決済ID、決済日時、金額、エラー内容を保存して、後から照合できるようにします。公開ページでは完了画面と再試行画面を分け、管理側では決済状態、通知結果、必要に応じた手動確認導線を用意すると運用しやすくなります。