API を利用した確認処理
API を使用して作成されたアカウントを持つプラットフォームは、顧客確認 (KYC) のためのユーザーに関する必要な情報を Stripe に提供できます。プラットフォームは、Connect アカウント登録を使用して KYC 情報を収集するか、Accounts API および Persons API を使用して Stripe に必要な情報を提供することができます。その後は Stripe で確認を行い、必要に応じて追加の情報を求めます。
このページの以降の部分では、プラットフォームで次のことを行う方法について説明します。
- 連結アカウントの確認要件を表示する
- Stripe に必要な情報を提供する
Custom 連結アカウントを使用するプラットフォームは、Custom アカウントの本人確認を参照し、確認フローのオプション、API フィールドを会社と個人の両方に変換する方法、および情報リクエストを現地の言語に変更する方法を確認することもできます。
注
API を使用して Stripe のリスク審査に対応することはできません。埋め込みコンポーネント、Stripe のホスティング登録、または修復リンクを使用して、連結アカウントが対応できるように設定できます。ダッシュボードを使用して、連結アカウントの代わりにリスク審査に対応することもできます。
確認プロセス
連結アカウントの支払いと入金を有効にする前に、Stripe は以下に応じて異なる特定の情報を必要とします。
- 連結アカウントの所在国
- 連結アカウントに適用される利用規約タイプ
- 連結アカウントでリクエストされるケイパビリティ
- ビジネスタイプ (個人か、会社かなど) および company.structure (公共団体か、非上場の共同経営会社かなど)
Platforms need to choose the proper onboarding flow for their business and users to meet the KYC requirements. Broadly speaking, this means providing all the requisite information upfront or incrementally. Either way, set up your integration to watch for and respond to requests from Stripe.
- Webhook 設定で Connect Webhook URL を設定し、アクティビティ、特に
account.updated
タイプのイベントを監視します。Persons API を使用する場合は、person.updated
イベントも監視する必要があります。 - Immediately after creating an account, check the
Account
object’s requirements.currently_due attribute for any additional requirements. Obtain any required information from the user and update the connected account. account.updated
イベント通知を継続的に監視して、requirements
ハッシュが変化しているかどうかを確認し、必要に応じて、追加情報をユーザーに求めます。
When you provide additional information, you don’t need to resubmit any previously verified details. For example, if the dob
is already verified, you don’t need to provide it again in subsequent updates.
注意
When requirements.currently_due
isn’t empty, additional information is required. Connected accounts might be blocked from creating charges, receiving payouts, or performing certain tasks if you don’t provide this information in a timely manner.
確認後に情報を変更する
After an individual or company is verified, you can change some of their information, with limitations. See the Update Account API for limitations based on the configuration of the connected account. Contact support to make changes outside of these limitations.
確認が必要かどうかを判断する
Webhook で account.updated
イベントを受信するか、API を介してアカウントを取得すると、Account (アカウント) オブジェクトを受信します。Account
オブジェクトの charges_enabled
属性と payouts_enabled
属性は、そのアカウントで支払いの作成や入金の受け取りが可能かどうかを示します。
Account
オブジェクトには、アカウントの確認に必要な要件を表す requirements
ハッシュがあります。
requirements
ハッシュには、次の配列があります。
eventually_due
: すべてのしきい値に達していると仮定して、収集が必要になる可能性のあるフィールドです。これらのフィールドが必要になるとcurrently_due
に表示され、current_deadline
が設定されます。必要な情報はすべてこの配列から始まります。currently_due
: 連結アカウントが無効にならないようにするために、current_deadline
までに収集する必要があるフィールド。currently_due
はeventually_due
のサブセットです。past_due
: 期限までに提出しなかったため、連結アカウントを無効にしたフィールド。past_due
はcurrently_due
のサブセットです。errors
: 確認が失敗した原因であるeventually_due
、currently_due
、past_due
ステータスにあるフィールドに関して再収集が必要である理由を示すリスト。disabled_reason
: 連結アカウントが有効ではない理由を説明します。current_deadline
:currently_due
のフィールドの収集期限を示す日付。currently_due
フィールドの収集前に次のしきい値に達した場合はアカウントがこの日付より前に無効化されることがあります。pending_verification
: 確認または審査の結果によっては必須になる可能性があるフィールド。非同期の確認が保留中でなければ空の配列になります。確認に失敗した場合、これらのフィールドはeventually_due
、currently_due
、past_due
のいずれかに移行します。検証に失敗しても別の検証が保留中の場合は、フィールドがeventually_due
、currently_due
、past_due
とともに、pending_verification
にも表示されることがあります。
以下の例は、アカウントに currently_due
の情報、eventually_due
の情報、確認の errors
を引き起こしている情報が含まれる場合に、requirements
ハッシュがどのように表示されるかを示しています。
{ "id":
, "object": "account", "requirements": { "disabled_reason": null, "current_deadline": 1529085600, "past_due": [], "currently_due": [ "company.tax_id", "company.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ], "eventually_due": [ "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.tax_id", "company.verification.document", "external_account", "tos_acceptance.date", "tos_acceptance.ip" ], "errors": [ { "requirement": "company.verification.document", "reason": "The company name on the account couldn't be verified. Either update your business name or upload a document containing the business name.", "code": "failed_name_match" }, ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
If requirements.currently_due
contains entries, check requirements.current_deadline
. The current_deadline
is a Unix timestamp identifying when information is needed. Usually, if Stripe doesn’t receive the information by the current_deadline
, payouts on the account are disabled. However, other consequences might apply in some situations. For example, if payouts are already disabled and the account is unresponsive to our inquiries, Stripe might also disable the ability to process charges.
これとは別に、requirements.disabled_reason プロパティに値を設定できます。値は、このアカウントで入金や支払いができない理由を説明する文字列です。プラットフォームと連結アカウントは、場合によっては理由を解決したり異議申し立てを行うためのフォームを送信できます。
- 標準の連結アカウントは、ダッシュボードにある追加の情報 (入手できる場合) にアクセスできます。
- Connect 環境に含まれているプラットフォームで審査するアカウントに移動すると、アカウントの
disabled_reason
が分かります。連結アカウントに代わって追加の情報を提供できる場合があります。無効になっている理由が異議申し立てに関連している場合は、異議申し立ての解決対象であるアカウントに、フォームへのリンクを生成できます。
理由 | 意味 |
---|---|
action_required.requested_capabilities | 連結アカウントのケイパビリティをリクエストする必要があります。詳細については、ケイパビリティのリクエストおよびリクエスト解除をご覧ください。 |
listed | Account might be on a prohibited persons or companies list (Stripe investigates and either rejects or reinstates the account accordingly). |
rejected.fraud | アカウントは、不正使用または違法なアクティビティの疑いがあるため、拒否されました。 |
rejected.incomplete_verification | 要求されたしきい値内での不完全な確認要件により、アカウントは拒否されています。 |
rejected.listed | アカウントは、サードパーティー (金融サービスプロバイダーまたは政府機関) の禁止された個人または会社のリストに記載されているため、拒否されました。 |
rejected.other | その他の理由でアカウントが拒否されました。 |
rejected.terms_of_service | アカウントは、利用規約違反の疑いがあるため、拒否されました。 |
requirements.past_due | このアカウントでケイパビリティを有効にするには、追加の確認情報が必要です。 |
requirements.pending_verification | Stripe は現在、連結アカウントの情報を確認しています。ご対応は不要です。requirements.pending_verification 配列を調べて、確認対象の情報をご覧ください。 |
under_review | Stripe がアカウントを審査しています。 |
検証エラーと確認エラー
Account (アカウント) オブジェクトには、requirements.errors 配列が含まれます。この配列は、アカウントとケイパビリティを有効にするために必要とされる検証および確認の要件が満たされていない理由を示します。errors
配列には次の属性が含まれます。
requirement
:currently_due
配列からのどの情報が必要かを指定します。code
: 発生したエラーのタイプを示します。発生する可能性のあるエラーコードについては、API リファレンスをご覧ください。reason
: エラーが発生した原因と解決方法について説明します。
要件が currently_due
であるアカウントの errors
配列がどのように表示されるかを示す例を以下に示します。この例は、提出された情報を使用してアカウントを有効にできない理由、およびエラーを解決する方法を示しています。検証または確認が失敗した場合、エラー情報とともに、要件が currently_due
に再表示される場合があります。これらの更新を受け取るには、Connect Webhook を設定して account.updated
イベントを受信します。
{ "id":
, "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [ "company.address.line1", "{{PERSON_ID}}.verification.document", ], "errors": [ { "requirement": "company.address.line1", "code": "invalid_street_address", "reason": "The provided street address cannot be found. Please verify the street name and number are correct in \"10 Downing Street\"", }, { "requirement": "{{PERSON_ID}}.verification.document", "code": "verification_document_failed_greyscale", "reason": "Greyscale documents cannot be read. Please upload a color copy of the document.", } ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
確認または検証には失敗しても、現在期限が来ている要件がない場合は、Webhook がトリガーされ、必要な情報に最終期日が設定されることが示されます。
ビジネス情報
When information about a business is submitted, Stripe verifies the new information. For example, Stripe might verify that the provided business URL is valid, reachable, and includes information about the business. To retrieve the status of verification information regarding a business, utilize the requirements
on the Account object.
以下は、ビジネス情報の確認に関連するエラーのリストです。
エラー | 解決策 |
---|---|
invalid_business_profile_name | ビジネス名は分かりやすい名前とし、認識できる単語で構成する必要があります。 |
invalid_business_profile_name_denylisted | 総称的なビジネス名やよく知られているビジネス名は使用できません。提供するビジネス名がアカウントのビジネスと一致していることを確認してください。 |
invalid_product_description_length | 商品の説明は 10 文字以上にしてください。 |
invalid_product_description_url_match | 商品の説明は、ビジネスの URL と異なるものにする必要があります。 |
| 以下のURL 確認のエラーを処理するをご覧ください。 |
明細書表記
Stripe は、アカウントへの設定時に明細書表記と明細書表記のプレフィックスを検証します。たとえば、Stripe は指定された明細書表記がビジネスの説明と一致することを確認する場合があります。明細書表記がビジネスの説明に一致することを検証する際、Stripe はカードネットワークに提供される部分を表す、明細書表記の最初の 22 文字を使用します。ビジネスの説明は、アカウントの business_profile.name
、business_profile.url
、会社または個人の名前と適合します。
明細書表記に関する本人確認情報のステータスを取得するには、Account オブジェクトの requirements
を確認します。以下は、明細書表記の確認に関連するエラーのリストです。
エラー | 解決策 |
---|---|
invalid_statement_descriptor_length | 明細書表記は、5 文字以上にする必要があります。 |
invalid_statement_descriptor_business_mismatch | 明細書表記は、アカウントのビジネス名、法人名、または URL と共通点があるものにする必要があります。 |
| 総称的な明細書表記やよく知られている明細書表記は使用できません。 |
invalid_statement_descriptor_prefix_mismatch | 明細書表記のプレフィックスは、明細書表記、ビジネス名、法人名、または URL と共通点があるものにする必要があります。 |
個人情報
確認プロセス中に、アカウントに関連付けられている個人に関する情報を収集する必要があります。お客様がアカウント登録する場合、以下のようにしてください。
- 会社のみをアカウント登録する場合は、Persons APIを使用してこの情報を収集します。
- 個人のみをアカウント登録する場合は、Persons API を使用するか、Account オブジェクトの individual ハッシュを使用できます。
- 個人と会社の組み合わせの場合、Persons API を使用してこの情報を収集します。このようにして、ビジネスタイプに関係なく同じ方法で情報を収集します。
個人に関する本人確認情報のステータスを取得するには、Person オブジェクトの verification サブハッシュを使用します。
{ "id":
, "object": "person", ... "verification": { "document": null } ... }"{{PERSON_ID}}"
Person オブジェクトで各本人確認属性の定義を検索できます。status
と details
という 2 つの属性に注目してください。
status
は、その人物の確認の状態を示します。
pending
: Stripe は現在この法人を確認しようとしています。unverified
: 確認が失敗したか、確認を試行するのに十分な情報がないため、Stripe は現在この法人を確認できません。verified
: Stripe はこの法人の確認を完了しています。
unverified
ステータスは必ずしも緊急の問題というわけではありませんが、Stripe がすぐに追加情報をリクエストする可能性があります。
details
属性は、現在の status
の説明を提供します。
以下は、個人の本人確認に関連するエラーのリストです。
エラー | 解決策 |
---|---|
invalid_address_city_state_postal_code | Stripe は提供された住所の市区町村、都道府県/州、郵便番号の組み合わせを検証できませんでした。 |
invalid_address_highway_contract_box | The address of the person must be a valid physical address from which the account conducts business and can’t be a Highway Contract Box. |
invalid_address_private_mailbox | The address of the person must be a valid physical address from which the account conducts business and can’t be a private mailbox. |
invalid_dob_age_under_minimum | 個人の年齢は 13 歳以上である必要があります。 |
invalid_dob_age_over_maximum | 個人の生年月日は過去 120 年以内である必要があります。 |
invalid_phone_number | Stripe はアカウントの電話番号を検証できませんでした。個人の国に合わせた形式を設定していることを確認してください。 |
invalid_street_address | Stripe は提供された住所の町名と番地を検証できませんでした。 |
| 納税者番号は、ダッシュなどの特殊文字を含まない 9 桁の固有の数字である必要があります。 |
国別の受付可能な確認書類
以下は、Stripe がサポートする各国の本人、住所、および法人の証明として Stripe が受付可能な書類のリストです。
書類の形式によっては、表と裏の両面を撮影する必要があります。この場合、document_back
パラメータを使用して書類の裏面を提供します。特に明記されていない限り、必要になるのは直接撮影された書類の表面のみです。
Stripe only accepts a passport to verify someone’s identity when a Stripe account and an individual associated with that Stripe account (for example, Business Representative, Owner) are from different countries. For example, if the business address is in the US, but the representative or owner of the business has a non-US address, then only their passport is accepted for verification of their identity. A passport scan is the only acceptable document in these cross-border situations.
会社情報
確認プロセスの際に、アカウントの会社に関する情報の収集が必要になる場合があります。
アカウントの会社に関する本人確認情報のステータスを取得するには、Account の company.verification サブハッシュを使用します。
{ "id":
, "object": "account", ... "company": { "verification": { "document": null }, ... }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Account (アカウント) オブジェクトで各本人確認属性の定義を検索できます。
書類確認時の問題に対処する
アップロードされた書類自体が確認プロセスを複雑化しています。最も一般的な問題を認識して処理するために、以下の表に (requirements.errors
配列の) エラー code
で発生し得る値と各エラーの考えられる解決策を示します。
以下は、書類のアップロードに関連するエラーのリストです。
エラー | 解決策 |
---|---|
| ファイル自体に問題があるため、アップロードに失敗しました。以下の要件を満たす新しいファイルを提供するようユーザに依頼してください。
|
| The provided file isn’t an acceptable form of ID from a supported country, or isn’t a type of legal entity document that is expected. Ask your user to provide a new file that meets that requirement. For a list, see Acceptable ID types by country. |
| Your team can contact Stripe to learn more about why identity verification failed. |
| 書類に発行日または有効期限がないか、書類の有効期限が切れています。本人確認書類の場合、有効期限は書類の提出日より後でなければなりません。住所確認書類の場合、発行日は過去 6 カ月以内でなければなりません。 |
以下は、本人確認に関連するエラーのリストです。
エラー | 解決策 |
---|---|
verification_failed_keyed_identity | アカウントの名前を確認できませんでした。完全な法人名を提供したことを確認し、その名前に一致する写真付き ID も提供するようユーザに依頼してください。 |
| ID 書類上の情報が、ユーザから提供された情報と一致しません。アカウントで提供された情報を確認して修正するようユーザに依頼してください。 |
| The document might have been altered so it couldn’t be verified. Your team can contact Stripe to learn more. |
以下は、ビジネス確認に関連するエラーのリストです。
エラー | 解決策 |
---|---|
| アカウントの情報が確認できませんでした。ユーザは書類をアップロードしてアカウントの詳細を確認するか、アカウントの情報を更新できます。 |
| ユーザーが提供した情報を、IRS では確認できませんでした。会社名または納税者番号で発生する可能性のあるエラーを修正するか、これらのフィールドを含む書類をアップロードするようにユーザーに依頼してください。(アメリカのみ) |
| 書類上の情報が、ユーザから提供された情報と一致しません。アカウントで提供された情報を確認して修正するか、アカウントと一致する情報が記載された書類をアップロードするようユーザに依頼してください。 |
| アップロードされた書類は必須のフィールドが抜けています。不足しているフィールドを含む別の書類をアップロードするようユーザに依頼してください。 |
注意
以前に失敗したファイルを再送信しないでください。重複したアップロードはすぐにエラーとなり、再確認されません。
URL 確認のエラーを処理する
EC ストア事業の URL は、カードネットワークの特定の基準に準拠している必要があります。URL に関するベストプラクティスおよび EC ストア事業に共通する要素については、ウェブサイトチェックリストをご覧ください。Stripe は、さまざまな形で URL の完全性を確認しています。URL の完全性に関するエラーを解決するには、以下の 2 つの方法があります。
- API を使用する: エラーコードを使用して URL の問題を処理します。URL の更新が必要な場合は、Update Account API を使用します。この API を使用した場合、Stripe は更新された URL の確認も実行します。URL の更新が不要な場合であっても、Stripe は URL を再確認してエラーを解消する必要があります。必要なその他の更新を実施した後、この API で URL を他の値に変更してから元に戻して、再確認が開始されるようにしてください。
- ダッシュボードを使用する: プラットフォームで、Stripe ダッシュボードの審査するアカウントページを使用すると、連結アカウントが受けている影響および対処の方法が分かります。
API を使用して、URL 関連の問題をすべて解決できるわけではありません。URL の完全性エラーの種類によっては、連結アカウントのウェブページにアクセスする方法について、またはアカウントが URL 要件への対応を免除されていることを証明する方法について、追加の情報が必要です。この種の問題を解決するには、お客様またはお客様の連結アカウントが補足情報を提供しなければなりません。審査するアカウントのページに移動してエラーを解決するか、連結アカウントに Stripe のサポートへの問い合わせ方法を案内してください。
注
Stripe’s Terms of Service requires all e-commerce businesses to populate the business_profile.url property with a working URL of their business website when activating an account with the card_payments
capability. An account is considered an e-commerce business if it promotes or sells any products or services through an online website, social media profile, or mobile application. If the account doesn’t operate a website to promote their business, sell products, or accept payments, they’re required to provide business_profile.product_description instead. A product description needs to detail the type of products being sold as well as the manner in which the account’s customers are being charged (i.e. in person transactions).
business_profile.url
フィールドに関連して発生する一般的なエラーを処理するための参考情報として、(requirements.errors
配列の) 関連エラーコードおよび考えられる解決策を以下の表に示します。
エラー | 解決策 |
---|---|
invalid_url_denylisted | アカウントに関して指定されている URL は、汎用の企業ウェブサイト URL と一致しています。アカウントを保有している企業固有の URL を指定してください。 |
invalid_url_format | アカウントに関して指定されている URL の形式が正しくありません。適切な形式の URL (https://example.com など) を指定してください。 |
invalid_url_website_inaccessible | アカウントに関して指定の URL のウェブサイトにアクセスできませんでした。この問題を解決するには、アクセス可能な URL を指定して、アカウントを更新してください。問題が解決しない場合、審査するアカウントダッシュボードページに移動し、必要なアクションリストでこの問題に対応するか、Stripe サポートまでお問い合わせください。 |
invalid_url_website_business_information_mismatch | アカウントのウェブサイトに関する情報が、アカウントの Stripe アカウントに関する情報と一致していません。ダッシュボードの「審査するアカウント」のページを確認するか、アカウントがウェブサイトに関する情報を確認して、アカウントの事業情報と一致する状態にしてください。 |
invalid_url_website_incomplete | アカウントのウェブサイトには、必須情報の一部が不足しているようです。 ウェブサイトに掲載する必要がある情報をご確認ください。 |
invalid_url_website_other | 指定されたウェブサイト、ソーシャルメディアのプロフィール、モバイルアプリケーションの URL ではアカウントの事業者を確認できません。新しい URL を指定してください。「審査するアカウント」のページを確認するか、URL が存在しない場合はアカウントが Stripe のサポートまでお問い合わせください。 |
invalid_url_web_presence_detected | We have detected that the account uses a website, social media profile, or mobile application to sell or promote products or services, but a URL hasn’t been provided for the account. The account should have a URL that isn’t a generic URL for the website or social media provider. |
invalid_url_website_incomplete_customer_service_details | アカウントのウェブサイトに、このアカウントのビジネスタイプでは必須の情報であるカスタマーサービスの詳細が掲載されていません。ダッシュボードの「審査するアカウント」のページを確認するか、必要な詳細をアカウントがウェブサイトに追加してください。 |
invalid_url_website_incomplete_return_policy | アカウントのウェブサイトに、このアカウントのビジネスタイプでは必須の情報である返品のポリシーとプロセスが掲載されていません。ダッシュボードの「審査するアカウント」のページを確認するか、返品のポリシーとプロセスをアカウントがウェブサイトに追加してください。 |
invalid_url_website_incomplete_refund_policy | アカウントのウェブサイトに、このアカウントのビジネスタイプでは必須の情報である返金ポリシーが掲載されていません。ダッシュボードの「審査するアカウント」のページを確認するか、アカウントが返金ポリシーをウェブサイトに追加してください。 |
invalid_url_website_incomplete_cancellation_policy | アカウントのウェブサイトに、このアカウントのビジネスタイプでは必須の情報であるキャンセルに関するポリシーが掲載されていません。ダッシュボードの「審査するアカウント」のページを確認するか、キャンセルに関するポリシーをアカウントがウェブサイトに追加してください。 |
invalid_url_website_incomplete_legal_restrictions | アカウントのウェブサイトで、法律上の制限または輸出規制の対象となっている商品を販売していることが示唆されています。ダッシュボードの「審査するアカウント」のページを確認するか、該当する商品をアカウントがウェブサイトから削除してください。 |
invalid_url_website_incomplete_terms_and_conditions | アカウントのウェブサイトに、このアカウントのビジネスタイプでは必須の情報である利用規約が掲載されていません。ダッシュボードの「審査するアカウント」のページを確認するか、アカウントが利用規約をウェブサイトに追加してください。 |
invalid_url_website_incomplete_under_construction | アカウントのウェブサイトは作成中の状態です。ダッシュボードの「審査するアカウント」のページを確認するか、アカウントがウェブサイトの作成を完了してください。 |
invalid_url_website_inaccessible_password_protected | アカウントのウェブサイトはパスワードで保護されています。ダッシュボードの「審査するアカウント」のページを確認するか、ウェブサイトへのアクセス方法を添えてアカウントが Stripe のサポートまでお問い合わせください。 |
invalid_url_website_inaccessible_geoblocked | アカウントのウェブサイトにジオブロッキング (地理的位置に応じたブロック) が適用されているため、Stripe がアクセスできませんでした。ダッシュボードの「審査するアカウント」のページを確認するか、ウェブサイトへのアクセス方法を添えてアカウントが Stripe のサポートまでお問い合わせください。 |
invalid_url_website_empty | アカウントのウェブサイトにコンテンツがありません。ダッシュボードの「審査するアカウント」のページを確認するか、商品やサービスを紹介するためのコンテンツをアカウントが追加してください。 |
本人確認を処理する
You can respond in two ways to an identity verification change. The first is to perform an Update Account call, correcting or adding information.
2 つ目は、Stripe からお客様に書類のアップロードを依頼する方法です。Stripe が確認できたユーザー情報の量に応じて、3 種類の書類のアップロードが必要になる場合があります。以下の requirements.currently_due
に一覧表示されているフィールドに基づいて、アップロードする書類を決定できます。
person.verification.document
: 受け入れ可能な形式の身分証明書を撮影したカラー画像が必要です。person.verification.additional_document
: 公共料金の請求書など、ユーザの住所が確認できる書類を直接撮影したカラー画像が必要です。company.verification.document
: 会社の定款など、ビジネスの法人 ID 番号を確認できる法人書類の証明書が必要です。
書類は、次の 2 段階のプロセスでアップロードします。
- Stripe にファイルをアップロードする
- アカウントにファイルを関連付ける
注
セキュリティ上の理由により、Stripe はメールで送信された ID のコピーは受け付けません。
ファイルをアップロードする
ファイルをアップロードするには、Create File API で POST を使用して、マルチパート/フォームデータリクエストの一部としてファイルデータを送信します。
アップロードするファイルは以下の要件を満たしている必要があります。
- カラー画像 (8,000 ピクセル x 8,000 ピクセル以下)
- 10 MB 以下
- Identity documents are JPG or PNG format
- Address or legal entity documents are JPG, PNG, or PDF format
ファイルデータを file
パラメーターに渡し、purpose
パラメーターを identity_document
に設定します。
このリクエストはファイルをアップロードし、トークンを返します。
{ "id":
, "created": 1403047735, "size": 4908 }"{{FILE_ID}}"
その後、トークンの id
値を使用して、連結アカウントに本人確認に使用されるファイルを関連付けることができます。
ファイルを添付する
After you upload the file and receive a representative token, provide the file ID using the appropriate field in your Update Account call.
以下は、本人確認書類の例です。
以下は、会社書類の例です。
この更新により、verification.status
が pending
に変更されます。さらに別の個人を確認する必要がある場合は、Persons API を使用して更新します。
身分証明書を確認する
身分証明書を直接撮影したカラー画像ファイルが Stripe の審査に通ると、書類要件は requirements.currently_due
から削除されます。個人または会社のすべての確認要件が満たされると、確認プロセスが完了したことを示す account.updated
Webhook 通知がトリガーされます。
提供された画像の読み取りやすさに応じて、確認が完了するまでに数分から数営業日かかる場合があります。
If the verification attempt fails, the requirements.errors
array contains an error stating the cause. The error[reason]
, such as “The image supplied isn’t readable,” is safe to present to your user, but isn’t localized. The response also contains an error[code]
value, such as verification_document_not_readable
, which you can use to localize errors for your users. Upon failure, requirements.currently_due
indicates that a new ID upload is required. If the deadline for verification is near, requirements.current_deadline
might also be populated with a date. Verification failure also triggers an account.updated
webhook notification.
Interested in receiving risk-related requirements?
Thank you! We'll be in touch soon.