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 "vendor_data=user-1234" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "personal_number=11111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PER",
services=["per_tax_registration"],
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
personal_number="11111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "PER",
Services: didit.Some([]string{"per_tax_registration"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("11111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("PER")
.services(List.of("per_tax_registration"))
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("11111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'PER',
'services' => ['per_tax_registration'],
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'personal_number' => '11111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "PER",
Services = new string[] { "per_tax_registration" },
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
PersonalNumber = "11111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"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"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PER",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PER",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "per_tax_registration",
"service_name": "Peru Tax Registration (SUNAT)",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
🇵🇪 पेरू
पेरू कर पंजीकरण (SUNAT) सत्यापन API
Didit की पहचान अवसंरचना के ज़रिए पेरू कर पंजीकरण (SUNAT) का आधिकारिक डेटाबेस सत्यापन। प्रति कॉल $2.92 से, कोई अनुबंध या न्यूनतम शर्त नहीं।
POST
/
v3
/
database-validation
/
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 "vendor_data=user-1234" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "personal_number=11111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PER",
services=["per_tax_registration"],
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
personal_number="11111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "PER",
Services: didit.Some([]string{"per_tax_registration"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("11111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("PER")
.services(List.of("per_tax_registration"))
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("11111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'PER',
'services' => ['per_tax_registration'],
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'personal_number' => '11111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "PER",
Services = new string[] { "per_tax_registration" },
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
PersonalNumber = "11111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"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"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PER",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PER",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "per_tax_registration",
"service_name": "Peru Tax Registration (SUNAT)",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
यह सेवा इनपुट डेटा को SUNAT के विरुद्ध सत्यापित करती है। Didit इसे
POST /v3/database-validation/ के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा को आधिकारिक स्रोत से मिलाकर सामान्यीकृत मिलान परिणाम प्राप्त कर सकें। इनपुट प्रारूप: personal_number में पेरू का DNI लिया जाता है (ठीक 8 अंक)।
कवरेज
- कवरेज: > 90%
- देश: Peru
- सेवा ID:
per_tax_registration - डेटा डोमेन: वित्तीय
- श्रेणी: कर रजिस्ट्री
इनपुट
| फ़ील्ड | आवश्यक | उदाहरण |
|---|---|---|
first_name | हाँ | John |
last_name | हाँ | Doe |
date_of_birth | हाँ | 1990-01-01 |
personal_number | हाँ | 11111111 |
vendor_data | नहीं | user-1234 |
- आवश्यक इनपुट:
first_name,last_name,date_of_birth,personal_number - वैकल्पिक इनपुट:
vendor_data - सहमति: आवश्यक नहीं
- वर्कफ़्लो उपलब्धता: वर्कफ़्लो में उपलब्ध
- कवरेज: > 90%
- कीमत: प्रति सफल क्वेरी $2.92
बॉडी पैरामीटर
string
डिफ़ॉल्ट:"PER"
आवश्यक
इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड।उदाहरण:
PERstring
डिफ़ॉल्ट:"per_tax_registration"
आवश्यक
इस सेवा ID वाली एक सरणी। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है।उदाहरण:
per_tax_registrationstring
डिफ़ॉल्ट:"John"
आवश्यक
सत्यापित किया जाने वाला पहला नाम।उदाहरण:
Johnstring
डिफ़ॉल्ट:"Doe"
आवश्यक
सत्यापित किया जाने वाला उपनाम।उदाहरण:
Doestring
डिफ़ॉल्ट:"1990-01-01"
आवश्यक
YYYY-MM-DD प्रारूप में जन्म तिथि।उदाहरण: 1990-01-01string
डिफ़ॉल्ट:"11111111"
आवश्यक
देश-विशिष्ट व्यक्तिगत पहचान संख्या।उदाहरण:
11111111string
डिफ़ॉल्ट:"user-1234"
इस व्यक्ति के लिए आपका स्थिर उपयोगकर्ता संदर्भ, जैसे आपकी आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्टैंडअलोन जाँचों को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लिकेट-पहचान के शोर को कम करने के लिए करता है।उदाहरण:
user-1234इनपुट नियम और सत्यापन नोट्स
- पेरू का DNI (ठीक 8 अंक)
personal_numberमें केवल अंक होने चाहिए। अनुरोध भेजने से पहले स्पेस, हाइफ़न और विराम चिह्न हटा दें।personal_numberकी लंबाई ठीक 8 वर्ण होनी चाहिए।
इसे कैसे कॉल करें
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 "vendor_data=user-1234" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "personal_number=11111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PER",
services=["per_tax_registration"],
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
personal_number="11111111",
vendor_data="user-1234",
)
print(result)
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234",
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "PER",
Services: didit.Some([]string{"per_tax_registration"}),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
PersonalNumber: didit.String("11111111"),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("PER")
.services(List.of("per_tax_registration"))
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.personalNumber("11111111")
.vendorData("user-1234")
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'PER',
'services' => ['per_tax_registration'],
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'personal_number' => '11111111',
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "PER",
services: ["per_tax_registration"],
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
personal_number: "11111111",
vendor_data: "user-1234"
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "PER",
Services = new string[] { "per_tax_registration" },
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
PersonalNumber = "11111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
हर सफल कॉल HTTP 200 लौटाती है। outcome_code फ़ील्ड बताता है कि वास्तव में क्या हुआ। यह उदाहरण के लिए एक वास्तविक बायोमेट्रिक मिलान न होने (BIOMETRIC_NO_MATCH) को उस सेल्फ़ी से अलग करता है जिसे पढ़ा नहीं जा सका (BIOMETRIC_IMAGE_UNUSABLE)। दिखाया गया status डिफ़ॉल्ट सुविधा स्थिति है। आपकी कॉन्फ़िगर की गई Partial Match / No Match कार्रवाइयाँ इसे बदल सकती हैं।MATCH: रजिस्ट्री ने पहचान की पुष्टि की और जाँचा गया हर फ़ील्ड मेल खाया।{
"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"
}
}
]
}
PARTIAL_MATCH: पहचान संख्या मिल गई, लेकिन एक या अधिक व्यक्तिगत फ़ील्ड (आमतौर पर नाम या जन्म तिथि) पूरी तरह मेल नहीं खाए।{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PER",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_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": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH: रजिस्ट्री ने सबमिट किए गए डेटा के लिए कोई मिलान नहीं लौटाया।{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PER",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "per_tax_registration",
"service_name": "Peru Tax Registration (SUNAT)",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH",
"identification_number": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match",
"identification_number": "no_match"
}
}
]
}
लौटाया गया डेटा
source_data में कौन-से सटीक फ़ील्ड दिखते हैं, यह इस पर निर्भर है कि रजिस्ट्री क्या लौटाती है। per_tax_registration के लिए बना उदाहरण वर्तमान में यह सामान्यीकृत संरचना दस्तावेज़ित करता है:
date_of_birthfirst_namefull_nameidentification_numberlast_namename_match_score
मूल्य निर्धारण और SLA
Peru Tax Registration (SUNAT) क्वेरी का शुल्क तभी लिया जाता है जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिलता है।- प्रति कॉल कीमत: $2.92 USD।
- बिलिंग: प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँच नहीं होती, आवश्यक फ़ील्ड गायब होते हैं, या अनुरोध स्रोत तक पहुँचने से पहले ही अस्वीकार हो जाता है, तो आपसे शुल्क नहीं लिया जाता।
- विलंबता: सामान्य p95 < 2 s।
- उपलब्धता: Didit की ओर से प्रति तिमाही 99.9%। डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार बदलती है।
आगे पढ़ें
अंतिम संशोधन 7 नवंबर 2026