実装の全体像
このマニュアルでは、Net Protections の EC 向け後払い決済サービスである atone と AFTEE を一度に接続できる統合 API について説明します。atone は日本国内向け、AFTEE は台湾・ベトナム向けの後払い決済サービスであり、両サービスを統一的に管理できるグローバルな API プラットフォームを提供しています。
統合対象
ユーザーがチェックアウトする画面の URL を取得する「事前登録 API」と、与信後の注文確定・取消などを扱う「取引操作 API」を接続します。atone/AFTEE のいずれも同一の API 設計で扱えます。
フロー概要（ホスト型チェックアウト）
sequenceDiagram
autonumber
participant User as ユーザー
participant MF as 加盟店(フロント)
participant MB as 加盟店(バックエンド)
participant NP as NP API
participant HP as NPチェックアウト画面
User->>MF: 支払い方法として atone / AFTEE を選択
MF->>MB: 決済開始リクエスト（カート/注文情報）
MB->>NP: 取引情報を連携（チェックアウト/決済作成）
NP-->>MB: チェックアウト画面URLを返却
MB-->>MF: チェックアウト画面URLを返却
MF-->>User: チェックアウト画面へ遷移を開始
MF->>HP: ユーザーをリダイレクト
User->>HP: 認証・新規登録を実施
NP-->>MB: Webhook: 認証完了通知
User->>HP: 金額確認・同意・購入確定
HP->>NP: 与信審査を実行
NP-->>HP: 審査結果（承認/拒否）
alt 与信承認
NP-->>MB: Webhook: 決済承認通知
MB-->>MF: 成立通知（任意）
MB->>MB: 出荷・請求確定など必要な処理を実施
else 与信拒否
NP-->>MB: Webhook: 決済拒否通知
MB->>MB: 別決済案内など
end
opt 必要に応じて
MB->>NP: 取引の更新・取消・取得（API）
NP-->>MB: 結果
end