ペルー納税者登録(SUNAT)検証API (JA)
ペルーの納税者番号をSUNATに対しリアルタイムで検証し、確実な結果に対してのみ課金されます。エンドポイント、パラメータ、レスポンススキーマ、料金、統合について説明します。.

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