概覽
資訊請求 (RFI) 是當合規團隊需要客戶提供更多資料時,Fluz 傳送給客戶的一組問題,最常出現在 KYB 審核期間(公司設立文件、地址證明、股權結構圖),有時也會在帳戶使用一段時間後出現。 RFI API 讓您的平台能在自己的 UI 中顯示這些請求並收集答覆,而不必將客戶導向 Fluz。透過四個操作,您可以:- 使用 openRfis 列出客戶尚未處理的 RFI,或讀取單一 RFI rfi,
- 使用 RFI 文件上傳端點上傳問題所要求的文件,
- 若您願意,可透過 completeRfiPlaidLink 以 Plaid 回覆銀行連結與地址相關問題,以及
- 使用 submitRfi 傳送答覆,可一次全部送出,也可分次送出。
IN_REVIEW,由 Fluz 進行審核。審核結果會以同一筆 RFI 的新狀態回傳。
問題依每筆 RFI individually 撰寫。 Fluz 會針對收件客戶建立每筆 RFI,因此各 RFI 的問題、順序及必填項目都不相同。請直接呈現 API 回傳的內容,而不要寫死表單。
需求
請在 Fluz 儀表板中,於應用程式的權限範圍內選取
MANAGE_RFI。客戶會在 OAuth 同意畫面上與其他範圍一樣核准此項目。請參閱應用程式範圍。
誰可以回覆 RFI
RFI 會寄給單一帳戶。權杖的accountId 必須是該帳戶,且權杖的使用者必須是該帳戶的收件人:
其他企業所有者、授權使用者與子使用者無法透過 API 讀取或回覆企業的 RFI。請為申請人在該企業的
accountId 上產生權杖。
流程
1
找出未處理的 RFI
使用客戶的權杖呼叫 openRfis。它會依最新優先的順序回傳所有等待客戶回覆的 RFI 及其問題。若清單為空,表示沒有待辦事項。
2
呈現問題
依
ordinal 順序顯示各個問題。使用 questionType 決定輸入類型,選擇題使用 options,並以 visibilityCondition 隱藏不適用的問題。請參閱問題類型。3
上傳文件
客戶每附加一個檔案,請使用
rfiId 與 questionId 呼叫上傳端點。請保留其回傳的 fileId。4
連結銀行(若有提供)
銀行對帳單與地址證明相關問題可以改用 Plaid 銀行連結回覆,而不必上傳檔案。開啟 Plaid Link 後,將 public token 傳給 completeRfiPlaidLink。
5
提交
使用答覆呼叫 submitRfi。若
finalize: true(預設值),RFI 會進入 IN_REVIEW。使用 finalize: false 可先儲存部分答覆,稍後再回來完成。6
追蹤結果
使用 rfi 再次讀取 RFI 以查看其狀態。若 Fluz 需要更多資料,同一筆 RFI 會帶著新問題回到
PENDING_DOCUMENTS,並再次出現在 openRfis 中。RFI 狀態生命週期
只有在 RFI 為
PENDING_DOCUMENTS 時才會回傳問題。在其他所有狀態下,questions 都是空清單。
具有未處理或審核中 RFI 的企業,在 getBusiness 中會顯示為
PENDING。提交 RFI 並不會核准該企業,請等待 kybStatus 變更。問題類型
每個答覆都以value 的形式放在 RfiAnswerInput 中傳送。其格式取決於問題的 questionType。
必填與選填問題
isOptional: false 表示必須先回答該問題,RFI 才能完成提交。選填問題可以略過。
條件式問題
當設定了visibilityCondition 時,只有在先前問題的答覆符合該條件時,該問題才適用。請在您的 UI 中評估該條件,以顯示或隱藏問題:
- 條件僅針對文字與選擇類答覆進行測試。檔案與銀行連結的答覆視為未作答。
- 不適用的問題不是必填,且您為其傳送的任何答覆都會被忽略。
Webhooks
若要在不輪詢的情況下得知 RFI 何時送達,請訂閱 RFI webhook 事件。請參閱 Webhooks。相關頁面
讀取 RFI
openRfis 與 rfi:問題、已儲存的答覆與狀態。上傳 RFI 文件
回傳您提交時所需
fileId 的 REST 端點。提交 RFI
儲存答覆、完成提交,並處理驗證錯誤。
以銀行連結回覆
以 Plaid 取代銀行對帳單或地址證明。