ブログ・ 2026年5月20日

グアテマラDPI検証API (JA)

グアテマラの国民IDを、国の公式政府身元登録機関に対してリアルタイムで検証し、確実な結果に対してのみ課金されます。エンドポイント、パラメータ、応答スキーマ、料金、統合について説明します。.

By Didit2026年5月20日更新日 2026年5月20日

グアテマラでユーザーをオンボーディングする際には、彼らが主張する人物であることを確認する必要があります。このAPIは、グアテマラのDPIをRENAP市民登録機関に対して検証します。書類や入力された情報は、データが存在することを証明するだけであり、それが本物であることや目の前の人物に属することを示すものではありません。グアテマラDPI検証は、国の公式政府身元登録機関に対してデータをチェックすることで、そのギャップを埋めます。このガイドでは、このチェックが何を行うのか、正確な技術的詳細、そして数分で統合する方法について説明します。

主なポイント：

何を確認するか — グアテマラDPI検証は、国民IDを国の公式政府身元登録機関に対して検証します。
何が返されるか — 正規化されたmatch_typeとフィールドレベルの結果が返され、承認/レビュー/却下ロジックに直接ルーティングできます。
なぜ重要か — 書類は偽造できますが、登録記録は偽造できません。信頼できる政府情報源に対してIDを検証することで、所有者が実在し、正しく特定されていることを確認できます。
使用方法 — Diditのデータベース検証エンドポイントへの1回のPOST、またはノーコードワークフローモジュールを使用します。確実なクエリあたり0.20ドルで、数秒で結果が得られます。

グアテマラDPI検証が検証する内容

グアテマラのDPIをRENAP市民登録機関に対して検証します。Diditはこれを単一のエンドポイントを通じて公開しており、提出されたデータを国の公式政府身元登録機関に対して検証し、構造化された正規化された結果を受け取ることができます。自分で解析する必要がある生の登録ダンプではありません。

確実な応答は、一致したsource_dataとフィールドごとのvalidationブロックを返し、リスクエンジンが明確で機械可読な判断を得られるようにします。

なぜ重要か

書類は偽造できますが、登録記録は偽造できません。信頼できる政府情報源に対してIDを検証することで、所有者が実在し、正しく特定されていることを確認できます。

グアテマラの規制対象ビジネス（フィンテック、暗号プラットフォーム、貸金業者、マーケットプレイス、ゲーミング事業者）にとって、信頼できる情報源に対してチェックを行うことで、身元がフォームや写真から単に取得されただけでなく、情報源で確認されたという弁護可能で監査可能な記録が作成されます。

技術詳細

Diditは、このサービスを統合されたデータベース検証エンドポイントを通じて公開しています。これは単一のPOSTであり、SDKは不要です。

エンドポイント

POST /v3/database-validation/

リクエストパラメータ

パラメータ	タイプ	必須	説明
`issuing_state`	string	Yes	ISO 3166-1 alpha-3 国コード。`GTM`を使用します。
`services`	string	Yes	サービス識別子。`gtm_dpi`を使用します。
`document_number`	string	Yes	ドキュメント番号。
`first_name`	string	No	名（オプションのクロスチェック）。
`last_name`	string	No	姓（オプションのクロスチェック）。

リクエスト例

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=GTM" \
  -F "services=gtm_dpi" \
  -F "document_number=1111111"

応答例（確実な一致）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "GTM",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "gtm_dpi",
      "service_name": "Guatemala - DPI verification",
      "source_data": {
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

パフォーマンスと請求

遅延: 通常数秒。
コスト: 確実なクエリあたり0.20ドル。確実な結果に対してのみ課金されます。情報源のダウンタイム、不足しているフィールド、情報源前の却下には課金されません。
信頼性: 四半期稼働率99.9%を目標とするDiditのインフラで稼働します。

ユースケース

フィンテック＆ネオバンク — グアテマラでウォレットを開設したり、信用を供与したりする前に、実在する検証可能な口座所有者であることを確認します。
暗号通貨＆Web3 — 信頼できる情報源の身元証明により、VASPのオンボーディング要件を満たします。
融資 — 情報源で検証されたデータにより、合成身元詐欺や第一者詐欺を減らします。
マーケットプレイス＆ギグプラットフォーム — 自己申告のフォームだけでなく、信頼できるデータに対してユーザーを検証します。
iGaming — 監査可能な履歴により、グアテマラのプレイヤーの身元と資格チェックを満たします。

Diditとの統合方法

グアテマラDPI検証は2つの方法で実行できます。

ノーコードワークフロー。 Diditビジネスコンソールで、ワークフロービルダーを開き、データベース検証モジュールを追加し、グアテマラ → グアテマラDPI検証を選択してアクティブ化します。一致するユーザーは自動的にルーティングされます。エンジニアリングは不要です。
直接API。 上記の/v3/database-validation/エンドポイントをservices=gtm_dpiで呼び出します。match_typeとフィールドごとのvalidationブロックを読み取り、承認/レビュー/却下ロジックを駆動します。

すべてのDiditアカウントには毎月500回の無料検証が含まれているため、1回のクエリに対して料金を支払う前に、完全なフローをエンドツーエンドでテストできます。

よくある質問

グアテマラDPI検証チェックは何を確認しますか？

提出されたデータを国の公式政府身元登録機関に対して検証し、正規化された一致結果を返します。これにより、国民IDが信頼できる情報源に存在するかどうか、およびどのフィールドが一致したかを確認できます。

情報源が一時的に利用できない場合はどうなりますか？

料金は課金されません。課金は確実な結果に対してのみ適用されます。情報源のダウンタイム、不足しているフィールド、情報源前の却下は無料です。

チェックの速度はどれくらいですか？

データベース検証は通常数秒で返されるため、リアルタイムのオンボーディングフローに適合します。

SDKは必要ですか？

いいえ。チェックは単一のエンドポイントへの1回のHTTPS POSTです。ビジネスコンソールでノーコードワークフローに組み込むこともできます。

始めましょうか？

今日から最初のグアテマラ国民IDを検証しましょう。

APIリファレンスを読む: グアテマラDPI検証
すべてのデータベース検証を見る: データベース検証の料金とカバー範囲
構築を開始する: 無料のDiditアカウントを作成 — 毎月500回まで無料検証。