特定のマスター口座に登録されている投資口座から手数料の計算と控除を開始します。通常は、CRM で発生した出金リクエストに関連付けられています。
エンドポイント
POST [host]/api/admin/fees/v2/fee/feeservice/processextリクエストボディ
| 名前 | 種類 | 必須 | 説明 |
|---|---|---|---|
| account_login | 文字列 | はい | アカウントのログイン (番号)。 |
| request_id | 文字列 | はい | 外部 CRM からの出金リクエスト ID (CRM の出金を B2COPY 手数料処理にリンクします)。 |
request_id について
CRM は出金用の一意の ID を生成し、それを request_id として渡します。ポーリングリクエストで同じIDを再利用して、その出金の料金支払いステータスを追跡します。
curl -X POST "[host]/api/admin/fees/v2/fee/feeservice/processext" \
-H "Authorization: Bearer <your-access-token>" \
-d '{
"account_login": "123456",
"request_id": "withdrawal_req_789"
}'応答とステータス
{
"account_login": "123456",
"request_id": "withdrawal_req_789",
"status": 1
}| ステータス | 名前 | 意味 |
|---|---|---|
| 1 | FEE_PROCESS_STATUS_PENDING | 処理中 (一時的) — 料金の支払いが進行中です。投票を開始します。 |
| 2 | FEE_PROCESS_STATUS_SUCCESS | 完了 (最終) — すべての料金が支払われました。それ以上のアクションはありません。 |
| 3 | FEE_PROCESS_STATUS_ERROR | エラー (最終) — 詳細を確認し、必要に応じて再試行します。 |
料金はかかりません
料金控除が必要ない場合、応答は PENDING ステータスを返さずに、すぐに FEE_PROCESS_STATUS_SUCCESS を返します。
ポーリング
最初のリクエストを送信する
account_loginおよびrequest_idを使用してメソッドを呼び出します。PENDINGでは、3 ～ 5 秒待ちます。同じ request_id で繰り返します
同じ ID を使用してメソッドを再度ポーリングします。
最終ステータスで停止
FEE_PROCESS_STATUS_SUCCESSまたはFEE_PROCESS_STATUS_ERRORを受け取るまで続行します。
