Personr (預覽)
使用 Personr 創建、驗證和檢索申請人數據。 輕鬆驗證身分並偵測複雜的詐欺行為。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 完整名稱 |
| URL | https://personr.co/contact |
| help@personr.co |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://personr.co |
| 隱私策略 | https://personr.co/legals |
| 類別 | 資料 |
Personr 簡化了身份驗證,同時檢測複雜的欺詐行為,使您的企業能夠遵守了解您的客戶 (KYC) 和反洗錢 (AML) 法規。 連接器可讓您建立、驗證和請求申請人的狀態和詳細資料。
先決條件
您將需要以下內容才能繼續...
- 作用中/訂閱的 Personr 帳戶。 如果您目前尚未訂閱,您可以透過前往 https://personr.co 或登入您的帳戶並選擇方案來訂閱。
如何取得認證
您需要產生一個授權持有者權杖,其有效期為一年。 若要這麼做,請將 POST 要求傳送至 https://enterprise.personr.co/api/1.1/wf/api-token-generate
正文應包含您的帳戶電子郵件和密碼。 API 會傳回包含您的授權持有者權杖的回應,如下列範例所示:
{
"status": "success",
"response": {
"token": "your_auth_token",
"expires": "expiry_date_in_seconds"
}
}
在設定期間將權杖輸入聯結器時,請確定權杖之前包含 Bearer 一詞: Bearer your_auth_token
開始使用連接器
要開始驗證您的第一個申請人,請按照以下方法操作。
建立您的第一個申請人。
使用 Create an Applicant action,然後輸入必要的詳細資料,例如他們的電子郵件、電話號碼,以及您希望他們經歷的流程。 您也可以輸入他們的名字和姓氏(可選)。
注意:應該 Flow Name 與您在平台上建立的相符。
建立驗證連結,或直接上傳文件。
您可以通過兩種方式驗證申請人 - 向他們提供驗證鏈接或直接以 base64 格式上傳他們的文件。
若要產生驗證連結,請使用動作 Create a Verification Link ,然後輸入您從上一個步驟收到的申請人 ID。 驗證鏈接允許申請人根據您選擇的流程上傳他們的文件。
使用驗證連結時,無需採取進一步的動作進行驗證,處理會自動開始。
若要直接將檔案上傳至申請人設定檔,請使用動作 Upload a Document 並輸入必要資訊,例如申請人ID、檔案型別、子型別、檔案國家/地區、檔案名稱和base64內容。
上傳所選流程所需的文件(正面和背面)後,請使用該 Request an Applicant Check 操作來確認並開始處理。 如果您使用驗證鏈結方法,則不需要這樣做,因為處理會自動開始。
注意:檔案名稱應包含副檔名,例如: id_card.jpg 此外,base64 內容不應包含檔案類型。 例如:/9j/4AAQSkZJRgABAQAAAQABAAD...
如需文件類型和子類型的詳細資訊,請參閱此處的公開文件: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd
檢索申請人的狀態和提取的信息。
驗證通常需要 ~2 分鐘來處理。 若要擷取申請人的狀態,請使用 Retrieve Applicant Status 具有相互關聯 applicantId 的動作。
此動作會提供 Approved 或 Rejected 答案、拒絕標籤和擷取的文件資訊。
擷取申請人的詳細資料。 (選擇性)
與上述動作類似, Retrieve Applicant Details 可讓您使用相互關聯的 applicantId 擷取申請人的其他資訊。
已知問題與限制
如果影像極度模糊或失焦,則無法進行驗證。 我們支持 JPEG、PNG 和 PDF 文件類型。
常見錯誤和補救措施
使用動作 Create an Applicant 時,如果您收到錯誤,請確定您的流程名稱與您在平台上建立的流程名稱相符。
使用 Upload a Document 動作上傳自拍影像時 (如果您的流程需要),請確定 文件型別 為 'SELFIE' ,而 文件子型別 為 'NULL'。
FAQ
如何驗證申請人的資料?
提取後,申請人數據將通過經過審查的政府和商業數據庫進行檢查,包括但不限於選民名冊、車輛、電信、死亡和其他登記處。
什麼是複雜的詐欺偵測或數位操縱?
複雜欺詐檢測或數字操縱檢測是檢查文檔是否被圖形編輯、偽造或非法在線購買的過程。 此過程在每次驗證時在背景運行,有助於在欺詐發生之前防止欺詐,從而保護企業和個人。
你們可以建立可用於我的業務的自訂流程嗎?
當然,每個企業都是獨一無二的(每次驗證也是如此)。 請與我們的團隊聯繫,他們將能夠根據您的要求創建定制流程。
哪些國家/地區支援驗證?
我們在全球範圍內驗證文件和個人,從駕駛執照到水電費帳單、銀行對帳單,甚至與政府當局的信件 - 無論語言或打字稿如何。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 授權權杖 | securestring | 輸入您的授權持有者權杖 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 將文件上傳給申請人 |
使用 base64 字串將文件上傳給申請人。 |
| 建立申請人 |
建立新的驗證申請人。 |
| 建立驗證連結 |
建立驗證連結以輕鬆上傳文件。 |
| 擷取申請人狀態 |
擷取申請人的驗證狀態及其詳細資料。 |
| 檢索申請人詳細信息 |
擷取申請人的詳細資料。 |
| 要求申請人檢查 |
確認所有文件都已上傳,然後開始檢查。 |
將文件上傳給申請人
使用 base64 字串將文件上傳給申請人。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
申請人編號
|
applicantId | string |
申請人標識碼 |
|
|
文件類型(例如ID_CARD)
|
docType | string |
文件類型 |
|
|
文件子類型(例如。FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
文件國家/地區 ISO(例如澳大利亞)
|
docCountryISO | string |
docCountryISO |
|
|
檔案名稱 + 副檔名(例如 document.jpeg)
|
filename | string |
filename |
|
|
檔案內容 (Base64 字串)
|
contents | string |
內容 |
建立申請人
建立新的驗證申請人。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
電子郵件地址
|
string |
電子郵件 |
||
|
電話號碼
|
phone | string |
phone |
|
|
名字
|
nameFirst | string |
nameFirst |
|
|
姓氏
|
nameLast | string |
name上一個 |
|
|
申請流程
|
flowName | string |
流名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | string |
狀態 |
|
申請人標識碼
|
response.applicantId | string |
申請人標識碼 |
|
電子郵件
|
response.email | string |
電子郵件 |
|
phone
|
response.phone | string |
phone |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
name上一個
|
response.nameLast | string |
name上一個 |
|
流名稱
|
response.flowName | string |
流名稱 |
|
申請人狀態
|
response.applicantStatus | string |
申請人狀態 |
建立驗證連結
建立驗證連結以輕鬆上傳文件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
申請人編號
|
applicant | string |
申請人 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | string |
狀態 |
|
驗證連結
|
response.verificationLink | string |
驗證連結 |
擷取申請人狀態
擷取申請人的驗證狀態及其詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
申請人編號
|
applicantId | string |
申請人標識碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | string |
狀態 |
|
申請人狀態
|
response.applicantStatus | string |
申請人狀態 |
|
申請人動作狀態
|
response.applicantActionStatus | string |
申請人動作狀態 |
|
修改日期
|
response.result.Modified Date | integer |
修改日期 |
|
建立日期
|
response.result.Created Date | integer |
建立日期 |
|
作者
|
response.result.Created By | string |
作者 |
|
審查答案
|
response.result.reviewAnswer | string |
審查答案 |
|
申請人
|
response.result.applicant | string |
申請人 |
|
評論客戶
|
response.result.commentClient | string |
評論客戶 |
|
公司
|
response.result.company | string |
公司 |
|
評論審核
|
response.result.commentModeration | string |
評論審核 |
|
拒絕標籤
|
response.result.rejectLabels | array of string |
拒絕標籤 |
|
review拒絕類型
|
response.result.reviewRejectType | string |
review拒絕類型 |
|
驗證
|
response.result.verification | string |
驗證 |
|
_id
|
response.result._id | string |
_id |
|
extractedFirstName
|
response.extractedFirstName | string |
extractedFirstName |
|
extractedLastName (提取的姓氏)
|
response.extractedLastName | string |
extractedLastName (提取的姓氏) |
|
extractedBirthDate (擷取出生日期)
|
response.extractedBirthDate | string |
extractedBirthDate (擷取出生日期) |
|
文件國家/地區
|
response.documentCountry | string |
文件國家/地區 |
|
extractedStreetNum
|
response.extractedStreetNum | string |
extractedStreetNum |
|
extractedStreet
|
response.extractedStreet | string |
extractedStreet |
|
extracted城市
|
response.extractedCity | string |
extracted城市 |
|
extracted狀態
|
response.extractedState | string |
extracted狀態 |
|
extracted郵遞區號
|
response.extractedPostCode | string |
extracted郵遞區號 |
檢索申請人詳細信息
擷取申請人的詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
申請人編號
|
applicantId | string |
申請人標識碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | string |
狀態 |
|
電子郵件
|
response.email | string |
電子郵件 |
|
phone
|
response.phone | string |
phone |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
name上一個
|
response.nameLast | string |
name上一個 |
|
tags
|
response.tags | array of |
tags |
|
流名稱
|
response.flowName | string |
流名稱 |
|
狀態
|
response.status | string |
狀態 |
要求申請人檢查
確認所有文件都已上傳,然後開始檢查。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
申請人編號
|
applicantId | string |
申請人標識碼 |