特定のマスターアカウントに登録されている投資アカウントから手数料の計算と控除を開始します。通常は、CRM で発生した出金リクエストに関連付けられています。
終点
POST [host]/api/admin/fees/v2/fee/feeservice/processextリクエストボディ
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| account_login | string | Yes | The account login (number). |
| request_id | string | Yes | The withdrawal request id from your external CRM (links the CRM withdrawal to B2COPY fee processing). |
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 | Processing (temporary) — fee payments in progress; start polling. |
| 2 | FEE_PROCESS_STATUS_SUCCESS | Done (final) — all fees paid; no further action. |
| 3 | FEE_PROCESS_STATUS_ERROR | Error (final) — check details and retry if needed. |
料金はかかりません
料金控除が必要ない場合、応答は PENDING ステータスなしで、直ちに FEE_PROCESS_STATUS_SUCCESS を返します。
ポーリング
最初のリクエストを送信する
account_loginおよびrequest_idを使用してメソッドを呼び出します。PENDINGでは、3 ～ 5 秒待ちます。同じ request_id で繰り返します
同じ ID を使用してメソッドを再度ポーリングします。
最終ステータスで停止
FEE_PROCESS_STATUS_SUCCESSまたはFEE_PROCESS_STATUS_ERRORを受け取るまで続けます。
