Personr (プレビュー)

Personr を使用して申請者データを作成、検証、取得します。 簡単に本人確認を行い、複雑な詐欺を検出します。

このコネクタは、次の製品および地域で利用可能です:

サービス クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 姓名
[URL] https://personr.co/contact
メール help@personr.co
Connector Metadata
発行者 マイクロソフト
Web サイト https://personr.co
プライバシー ポリシー https://personr.co/legals
カテゴリー 日付

Personr は、複雑な詐欺を検出しながら本人確認を簡素化し、ビジネスが顧客確認 (KYC) およびマネーロンダリング防止 (AML) 規制に準拠できるようにします。 コネクタを使用すると、申請者のステータスと詳細を作成、確認、要求できます。

前提条件

続行するには、次のものが必要です...

  • アクティブな/購読済み Personr アカウント。 現在購読していない場合は、https://personr.co にアクセスするか、アカウントにログインしてプランを選択することで購読できます。

資格情報の入手方法

1 年間有効な承認ベアラー トークンを生成する必要があります。 これを行うには、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 your_auth_token の前に「ベアラー」という単語が含まれていることを確認してください。

コネクタの使用を開始する

最初の申請者の認証を開始するには、以下の方法に従ってください。

最初の申請者を作成します。

Create an Applicant action を使用して、メール、電話番号、希望するフローなどの必要な詳細を入力します。 名および姓を入力することもできます (オプション)。

注意: Flow Name は、プラットフォーム上で作成したものと一致する必要があります。

検証リンクを作成するか、ドキュメントを直接アップロードします。

申請者を確認するには、申請者に検証リンクを提供するか、base64 形式で書類を直接アップロードするという 2 つの方法があります。

検証リンクを生成するには、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 分かかります。 申請者のステータスを取得するには、関連する applicantId を指定して Retrieve Applicant Status アクションを使用します。

このアクションにより、Approved または Rejected 回答、拒否ラベル、および抽出されたドキュメント情報が提供されます。

申請者の詳細を取得します。 (任意)

上記のアクションと同様に、Retrieve Applicant Details を使用すると、関連付けられた applicantId を使用して、申請者に関する追加情報を取得できます。

既知の問題と制限事項

画像が極端にぼやけていたり、焦点が合っていない場合、検証は続行されません。 JPEG、PNG、PDF のファイル タイプをサポートします。

一般的なエラーと解決策

Create an Applicant アクションを使用するときにエラーが発生した場合は、フロー名がプラットフォームで作成したものと一致していることを確認してください。

Upload a Document アクションを使用して自撮り画像をアップロードする場合 (フローで必要な場合)、ドキュメント タイプが "SELFIE"、ドキュメント SubType が "NULL" であることを確認してください。

よくあるご質問

申請者のデータはどのように検証されますか?

抽出された申請者のデータは、選挙人名簿、車両、通信事業者、死亡、その他の登録簿を含むがこれらに限定されない、精査された政府および商業データベースと照合されます。

複雑な不正行為の検出またはデジタル操作とは何ですか?

複雑な不正行為の検出、またはデジタル操作の検出は、ドキュメントがグラフィカルに編集、偽造、オンラインで違法に購入されていないかどうかを確認するプロセスです。 このプロセスは検証ごとにバックグラウンドで実行され、不正行為が発生する前に防止し、企業と個人を保護するのに役立ちます。

自分のビジネスに使用できるカスタム フローを作成できますか?

もちろんです。まったく同じビジネスはありません (そしてどの検証も同様です)。 マイクロソフトのチームにお問い合わせください。お客様の要件に合わせたカスタム フローを作成いたします。

検証にはどの国がサポートされていますか?

言語や活字に関係なく、運転免許証から公共料金請求書、銀行取引明細書、さらには政府当局との通信に至るまで、ドキュメントと個人を世界中で検証します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ プロパティ 必須
認証トークン securestring 認証ベアラー トークンを入力します True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

アプリケーションを作成する

新しいアプリケーションを作成します。

検証リンクの作成

検証リンクを作成して、ドキュメントを簡単にアップロードします。

申請者にドキュメントをアップロードする

Base64 文字列を使用してドキュメントを申請者にアップロードします。

申請者のステータスの取得

申請者の検証ステータスとその詳細を取得します。

申請者の詳細を取得する

申請者の詳細を取得します。

申請者チェックの要求

すべてのドキュメントがアップロードされていることを確認し、チェックを開始します。

アプリケーションを作成する

新しいアプリケーションを作成します。

パラメーター

名前 キー 必須 説明
電子メールアドレス
email string

メールアドレス

電話番号
phone string

電話番号

nameFirst string

nameFirst

nameLast string

nameLast

申請者フロー
flowName string

flowName

戻り値

名前 パス 説明
ステータス
status string

ステータス

applicantId
response.applicantId string

applicantId

メールアドレス
response.email string

メールアドレス

電話番号
response.phone string

電話番号

nameFirst
response.nameFirst string

nameFirst

nameLast
response.nameLast string

nameLast

flowName
response.flowName string

flowName

applicantStatus
response.applicantStatus string

applicantStatus

検証リンクの作成

検証リンクを作成して、ドキュメントを簡単にアップロードします。

パラメーター

名前 キー 必須 説明
申請者 ID
applicant string

申請者

戻り値

名前 パス 説明
ステータス
status string

ステータス

verificationLink
response.verificationLink string

verificationLink

申請者にドキュメントをアップロードする

Base64 文字列を使用してドキュメントを申請者にアップロードします。

パラメーター

名前 キー 必須 説明
申請者 ID
applicantId string

applicantId

ドキュメントの種類 (例 ID_CARD)
docType string

docType

ドキュメントのサブタイプ (例 FRONT_SIDE)
docSubType string

docSubType

ドキュメントの国 ISO (例 オーストラリア)
docCountryISO string

docCountryISO

ファイル名 + 拡張機能 (例 document.jpeg)
filename string

ファイル名

ファイル コンテンツ (Base64 文字列)
contents string

目次

戻り値

申請者のステータスの取得

申請者の検証ステータスとその詳細を取得します。

パラメーター

名前 キー 必須 説明
申請者 ID
applicantId string

applicantId

戻り値

名前 パス 説明
ステータス
status string

ステータス

applicantStatus
response.applicantStatus string

applicantStatus

applicantActionStatus
response.applicantActionStatus string

applicantActionStatus

変更日
response.result.Modified Date integer

変更日

作成日
response.result.Created Date integer

作成日

作成者
response.result.Created By string

作成者

reviewAnswer
response.result.reviewAnswer string

reviewAnswer

申請者
response.result.applicant string

申請者

commentClient
response.result.commentClient string

commentClient

会社名
response.result.company string

会社名

commentModeration
response.result.commentModeration string

commentModeration

rejectLabels
response.result.rejectLabels array of string

rejectLabels

reviewRejectType
response.result.reviewRejectType string

reviewRejectType

確認
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

documentCountry
response.documentCountry string

documentCountry

extractedStreetNum
response.extractedStreetNum string

extractedStreetNum

extractedStreet
response.extractedStreet string

extractedStreet

extractedCity
response.extractedCity string

extractedCity

extractedState
response.extractedState string

extractedState

extractedPostCode
response.extractedPostCode string

extractedPostCode

申請者の詳細を取得する

申請者の詳細を取得します。

パラメーター

名前 キー 必須 説明
申請者 ID
applicantId string

applicantId

戻り値

名前 パス 説明
ステータス
status string

ステータス

メールアドレス
response.email string

メールアドレス

電話番号
response.phone string

電話番号

nameFirst
response.nameFirst string

nameFirst

nameLast
response.nameLast string

nameLast

タグ
response.tags array of

タグ

flowName
response.flowName string

flowName

ステータス
response.status string

ステータス

申請者チェックの要求

すべてのドキュメントがアップロードされていることを確認し、チェックを開始します。

パラメーター

名前 キー 必須 説明
申請者 ID
applicantId string

applicantId

戻り値