ブラジルCPFステータス確認API (JA)
ブラジルの納税者番号を国の税務当局に対してリアルタイムで検証し、確定的な結果に対してのみ課金されます。エンドポイント、パラメーター、レスポンススキーマ、料金、統合について説明します。.
ブラジルでユーザーをオンボーディングする際には、彼らが主張する本人であることを確認する必要があります。SERPROを介して連邦税庁からCPFステータス（通常、一時停止、キャンセル）、氏名、生年月日を返します。書類や入力された情報は、データが存在することを証明するだけで、それが本物であるか、目の前の人物のものであるかを証明するものではありません。ブラジルCPFステータス確認検証は、国の税務当局に対してデータをチェックすることで、そのギャップを埋めます。このガイドでは、このチェックが何をするのか、正確な技術的詳細、そして数分で統合する方法を説明します。
主なポイント:
- チェック内容 — ブラジルCPFステータス確認検証は、国の税務当局に対して納税者番号を検証します。
- 返される内容 — 正規化された
match_typeと、承認/レビュー/拒否のロジックに直接組み込めるフィールドレベルの結果。 - なぜ重要か — 税務ID検証は、申請者を検証可能な財政的IDに結び付け、合成ID詐欺や一次詐欺を減らします。
- 使用方法 — Diditのデータベース検証エンドポイントへの1回の
POST、またはノーコードのワークフローモジュール。1回の確定的なクエリにつき0.20ドル、数秒で結果が得られます。
ブラジルCPFステータス確認検証が検証する内容
SERPROを介して連邦税庁からCPFステータス（通常、一時停止、キャンセル）、氏名、生年月日を返します。Diditはこれを単一のエンドポイントを通じて公開しており、これにより提出されたデータを国の税務当局に対して検証し、構造化された正規化された結果を受け取ることができます。自分で解析する必要がある生のレジストリダンプではありません。
確定的な応答は、一致したsource_dataとフィールドごとのvalidationブロックを返し、リスクエンジンが明確で機械可読な判断を得られるようにします。
なぜ重要か
税務ID検証は、申請者を検証可能な財政的IDに結び付け、合成ID詐欺や一次詐欺を減らします。
ブラジルの規制対象ビジネス（フィンテック、暗号通貨プラットフォーム、貸金業者、マーケットプレイス、ゲーム運営者）にとって、信頼できる情報源と照合することは、IDがフォームや写真から単に取得されただけでなく、情報源で確認されたという、防御可能で監査可能な記録を作成します。
技術詳細
Diditはこのサービスを統合されたデータベース検証エンドポイントを通じて提供します。これは単一のPOSTであり、SDKは不要です。
エンドポイント
POST /v3/database-validation/リクエストパラメーター
| パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
issuing_state | string | Yes | ISO 3166-1 alpha-3 国コード。BRAを使用。 |
services | string | Yes | サービス識別子。bra_cpfを使用。 |
tax_number | string | Yes | 納税者番号。 |
first_name | string | No | 名（オプションのクロスチェック）。 |
last_name | string | No | 姓（オプションのクロスチェック）。 |
date_of_birth | string | No | 生年月日（オプションのクロスチェック）。 |
リクエスト例
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf" \
-F "tax_number=1111111"レスポンス例（確定的な一致）
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf",
"service_name": "Brazil - CPF status check",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"lgpd_minor": "sample_value",
"minor_under_16": "sample_value",
"minor_under_18": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}パフォーマンスと請求
- 遅延: 通常数秒。
- コスト: 確定的なクエリ1回あたり0.20ドル。確定的な結果に対してのみ課金され、ソースのダウンタイム、フィールドの欠落、またはソース前の拒否には課金されません。
- 信頼性: 四半期稼働率99.9%を目標とするDiditのインフラストラクチャで実行されます。
使用事例
- フィンテック＆ネオバンク — ブラジルでウォレットを開設したり信用を供与したりする前に、実在し検証可能な口座名義人であることを確認します。
- クリプト＆Web3 — 信頼できる情報源による本人確認でVASPのオンボーディング要件を満たします。
- 融資 — 情報源で検証されたデータにより、合成ID詐欺や一次詐欺を減らします。
- マーケットプレイス＆ギグプラットフォーム — 自己申告のフォームだけでなく、信頼できるデータに対してユーザーを検証します。
- iGaming — 監査可能な記録により、ブラジル人プレイヤーの本人確認と適格性チェックを満たします。
Diditとの統合方法
ブラジルCPFステータス確認検証は、次の2つの方法で実行できます。
- ノーコードワークフロー。 Diditビジネスコンソールで、ワークフロービルダーを開き、データベース検証モジュールを追加し、ブラジル → ブラジルCPFステータス確認検証を選択してアクティブ化します。一致するユーザーは自動的にルーティングされ、エンジニアリングは不要です。
- 直接API。 上記の
/v3/database-validation/エンドポイントをservices=bra_cpfで呼び出します。match_typeとフィールドごとのvalidationブロックを読み取り、承認/レビュー/拒否のロジックを駆動します。
すべてのDiditアカウントには毎月500回の無料検証が含まれているため、1回のクエリに料金を支払う前に、完全なフローをエンドツーエンドでテストできます。
よくある質問
ブラジルCPFステータス確認検証チェックは何を確認しますか？
これは、提出されたデータを国の税務当局に対して検証し、正規化された一致結果を返します。これにより、納税者番号が信頼できる情報源に存在するかどうか、およびどのフィールドが一致したかを知ることができます。
ソースが一時的に利用できない場合はどうなりますか？
料金は発生しません。請求は確定的な結果に対してのみ適用され、ソースのダウンタイム、フィールドの欠落、ソース前の拒否は無料です。
チェックはどのくらい速いですか？
データベース検証は通常数秒で返されるため、リアルタイムのオンボーディングフローに適合します。
SDKは必要ですか？
いいえ。このチェックは、1つのエンドポイントへの単一のHTTPS POSTです。ビジネスコンソールでノーコードワークフローに組み込むこともできます。
始めませんか？
今日、最初のブラジルの納税者番号を検証しましょう。
- APIリファレンスを読む: ブラジルCPFステータス確認検証
- すべてのデータベース検証を見る: データベース検証の料金とカバー範囲
- 構築を開始する: 無料のDiditアカウントを作成 — 毎月500回の検証が無料です。