銀行API連携を段階的に確かめ、 「freee振込」をMVPまで運んだ方法 「わからないことがわからない」を実行・観測で減らす

freee 技術の日 2026のセッション資料です。

Transcript

1. 銀⾏API連携を段階的に確かめ、 「freee振込」をMVPまで運んだ⽅法 「わからないことがわからない」を実⾏‧観測で減らす ふぃる 2026年10⽉3⽇
2. freee振込 開発チーム エンジニア ふぃる 2024年4⽉に新卒でfreeeに⼊社。 freee振込の⽴ち上げから現在まで 開発を担当。
3. 銀⾏APIと、それに連動する仕組み 振込実⾏ 銀⾏API freee⽀出管理 申請‧承認 銀⾏API 実際の資⾦移動 freee振込 銀⾏の送⾦APIだけでなく、権限‧認証‧状態遷移‧⾃動消込が連動する 権限 認証 状態遷移 API仕様書をそのまま鵜呑みにして設計‧実装した結果、 ⼤きな⼿戻りになったことはありませんか？ 今⽇は、この機能を MVP まで運んだ過程を話します ⾃動消込
4. 完成を待たず、本番で1円を動かすことを最初のゴールにした ⼀番の⽬的は、実際にお⾦が動く振込を 『振込依頼API』を⽤いて早めに試験すること 選んだ 選ばな かった 本番環境‧1円‧チーム内送⾦で、 振込依頼APIとステータス取得を早期に試す ‧画⾯の完成を待って、最後に結合で確かめる ‧試験環境だけで済ませる 2025年某⽇ 本番環境‧1円‧チーム内送⾦で成功 1円振り込めたことはMVPではなかった。未知をひとつ減らしただけ。
5. 画⾯の完成を待たず、銀⾏APIの挙動を⾃分たちの⼿で確かめた 試験環境で確かめた 実送⾦で確かめた 各種APIのバリデーション‧エラーコード 受取⼈名義相違後の資⾦返却 1円送⾦とステータス取得 未来⽇振込と状態遷移 休⽇の他⾏宛振込 照会系API 仕様を読む モアタイム時間帯の本番挙動 APIを実⾏する 実際の挙動を観測する ↺ 繰り返す ‧⼀括振込に１つモアタイム⾮対応先を含めると、他の振込⽇時がどうなるか ‧受取⼈名義を相違させた振込が何⽇後に資⾦返却されるところまで観測 次の確認事項が⾒つかる
6. 観測結果を、設計とリリース判断に使える証拠へ変えた APIを実⾏ 挙動‧疑問を観測 証拠へ変換 設計‧実装 質問表∕状態遷移図∕テストチャーター∕受⼊基準 資⾦返却 リトライ テストチャーター テストチャーター 振込APIを試したメンバー 振込依頼の受⼊基準 不明な外部仕様 銀⾏とのコミュニケーション 「画⾯の完成を待たずに APIテストを実⾏できた」 「実際にぽちぽちしたことが、 その後のAPI仕様の議論に役⽴った」 反省：早く動かすことと、雑な本実装を残すことは別 探索⽤実装には「捨てる∕作り直す∕育てる」の出⼝を明⽰する
7. Key Message まず動かすとは、完成を急ぐことではない。 未知を、次の意思決定に使える証拠へ変えること。 読んで待つ 未知 試しに書いたコードが残る 動かして観測する 問い → 証拠 捨てる∕作り直す∕育てるを先に決める