curl -X POST \
https://verification.didit.me/v3/session/3fa85f64-5717-4562-b3fc-2c963f66afa6/decision-email-preview/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"new_status": "Approved", "email_language": "en"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.preview_decision_email(
"3fa85f64-5717-4562-b3fc-2c963f66afa6",
new_status="Approved",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.previewDecisionEmail("3fa85f64-5717-4562-b3fc-2c963f66afa6", {
new_status: "Approved",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.PreviewDecisionEmail(ctx, "3fa85f64-5717-4562-b3fc-2c963f66afa6", didit.SessionsPreviewDecisionEmailParams{
NewStatus: "Approved",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsPreviewDecisionEmailParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().previewDecisionEmail("3fa85f64-5717-4562-b3fc-2c963f66afa6", SessionsPreviewDecisionEmailParams.builder()
.newStatus(SessionsPreviewDecisionEmailParams.NewStatus.of("Approved"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->previewDecisionEmail('3fa85f64-5717-4562-b3fc-2c963f66afa6', [
'new_status' => 'Approved',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.preview_decision_email(
"3fa85f64-5717-4562-b3fc-2c963f66afa6",
new_status: "Approved"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.PreviewDecisionEmailAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6", new SessionsPreviewDecisionEmailParams
{
NewStatus = "Approved",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"recipient": "person@example.com",
"recipient_source": "email_verification",
"sender": "Example App <no-reply@mail.example.com>",
"sender_name": "Example App",
"sender_email": "no-reply@mail.example.com",
"sender_kind": "customer",
"subject": "Your verification has been approved in Example App",
"html": "<!DOCTYPE html><html><body>...</body></html>",
"language": "en",
"will_be_sent": true,
"not_sent_reason": null,
"preview_token": "eyJkaWdlc3QiOiI0ZjJhIn0:1uExAm:Pl3x4mpleS1gnatureValue000000000000000"
}निर्णय ईमेल पूर्वावलोकन API: स्वीकृत और अस्वीकृत ईमेल
Didit से स्वीकृत या अस्वीकृत ईमेल का पूर्वावलोकन करें: प्राप्तकर्ता, प्रेषक और भाषा के साथ, सत्र की स्थिति बदलने से पहले।
curl -X POST \
https://verification.didit.me/v3/session/3fa85f64-5717-4562-b3fc-2c963f66afa6/decision-email-preview/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"new_status": "Approved", "email_language": "en"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.preview_decision_email(
"3fa85f64-5717-4562-b3fc-2c963f66afa6",
new_status="Approved",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.previewDecisionEmail("3fa85f64-5717-4562-b3fc-2c963f66afa6", {
new_status: "Approved",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.PreviewDecisionEmail(ctx, "3fa85f64-5717-4562-b3fc-2c963f66afa6", didit.SessionsPreviewDecisionEmailParams{
NewStatus: "Approved",
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsPreviewDecisionEmailParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().previewDecisionEmail("3fa85f64-5717-4562-b3fc-2c963f66afa6", SessionsPreviewDecisionEmailParams.builder()
.newStatus(SessionsPreviewDecisionEmailParams.NewStatus.of("Approved"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->previewDecisionEmail('3fa85f64-5717-4562-b3fc-2c963f66afa6', [
'new_status' => 'Approved',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.preview_decision_email(
"3fa85f64-5717-4562-b3fc-2c963f66afa6",
new_status: "Approved"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.PreviewDecisionEmailAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6", new SessionsPreviewDecisionEmailParams
{
NewStatus = "Approved",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"recipient": "person@example.com",
"recipient_source": "email_verification",
"sender": "Example App <no-reply@mail.example.com>",
"sender_name": "Example App",
"sender_email": "no-reply@mail.example.com",
"sender_kind": "customer",
"subject": "Your verification has been approved in Example App",
"html": "<!DOCTYPE html><html><body>...</body></html>",
"language": "en",
"will_be_sent": true,
"not_sent_reason": null,
"preview_token": "eyJkaWdlc3QiOiI0ZjJhIn0:1uExAm:Pl3x4mpleS1gnatureValue000000000000000"
}send_email: true के साथ Approved या Declined पर सेट करते हैं, तो प्रतिक्रिया में वही ईमेल दिखता है जैसा व्यक्ति उसे प्राप्त करता है।
यह यह भी बताती है कि ईमेल किसे मिलेगा, वह किसकी ओर से आएगा, और पुष्टि करने पर ईमेल भेजा जाएगा या नहीं।
किसे ईमेल मिलता है
ईमेल व्यक्ति के अपने पते पर जाता है: वह पता जिसे उसने वर्कफ़्लो के ईमेल सत्यापन चरण में सत्यापित किया था, या यदि वह नहीं है, तो सत्र बनाते समयcontact_details में दिया गया पता।
recipient_source बताता है कि कौन सा लागू होता है (email_verification या contact_details)।
यदि सत्र में व्यक्ति के लिए कोई पता नहीं है, तो recipient, recipient_source और preview_token खाली स्ट्रिंग होते हैं और कोई ईमेल नहीं भेजा जा सकता।
जब आपका व्हाइट-लेबल कॉन्फ़िगरेशन लागू होता है (sender_kind: customer), तो ईमेल आपके एप्लिकेशन के सत्यापित प्रेषक डोमेन से जाता है। अन्यथा वह Didit के प्रेषक से जाता है (sender_kind: didit)।
ईमेल भेजा जाएगा या नहीं
will_be_sent तब true होता है जब send_email: true के साथ परिवर्तन की पुष्टि करने पर ईमेल भेजा जाता है।
जब यह false होता है, तो not_sent_reason कारण बताता है:
not_sent_reason | इसका अर्थ |
|---|---|
status_unchanged | सत्र की यह स्थिति पहले से है, इसलिए अपडेट कुछ नहीं बदलता और कोई ईमेल नहीं भेजता। |
notification_emails_disabled | सत्र contact_details.send_notification_emails: true के बिना बनाया गया था, इसलिए contact_details में दिए पते पर कोई निर्णय ईमेल नहीं जाता। |
no_recipient | व्यक्ति के लिए कोई पता ज्ञात नहीं है। |
sandbox | सत्र एक सैंडबॉक्स सत्र है और प्राप्तकर्ता ने सैंडबॉक्स ईमेल डिलीवरी के लिए सहमति नहीं दी है, इसलिए ईमेल केवल सिमुलेट किया जाता है। देखें ईमेल ऑप्ट-इन। |
निर्णय की पुष्टि करें
इन फ़ील्ड्स के साथ सत्र स्थिति अपडेट करें API कॉल करें:| सत्र स्थिति अपडेट करें फ़ील्ड | मान |
|---|---|
new_status | वही new_status जिसका आपने पूर्वावलोकन किया था |
send_email | true |
email_address | पूर्वावलोकन से recipient |
email_language | पूर्वावलोकन से language |
email_preview_token | पूर्वावलोकन से preview_token |
409 लौटाता है।
फिर से पूर्वावलोकन करें और नई रसीद के साथ पुष्टि करें।
संबंधित
- सत्र स्थिति अपडेट करें: सत्र को स्वीकृत या अस्वीकृत करें और ईमेल भेजें।
- पुनः सबमिशन ईमेल का पूर्वावलोकन करें: इसके बजाय पुनः सबमिशन के लिए ईमेल का पूर्वावलोकन करें।
- व्हाइट लेबल: ईमेल द्वारा उपयोग किया जाने वाला प्रेषक और ब्रांडिंग।
प्राधिकरण
आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।
पथ पैरामीटर
सत्यापन सत्र का UUID। उपयोगकर्ता (KYC) और व्यवसाय (KYB) दोनों सत्र ID स्वीकार करता है।
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
बॉडी
वह निर्णय जिसके ईमेल का आप पूर्वावलोकन करना चाहते हैं।
Approved, Declined "Approved"
ईमेल की भाषा, Update Session Status के समान डिफ़ॉल्ट। जो भाषा उपलब्ध नहीं है वह अंग्रेज़ी पर फ़ालबैक हो जाती है; रिस्पॉन्स में language बताता है कि किसका उपयोग किया गया है।
"en"
प्रतिक्रिया
केवल पूर्वावलोकन। सत्र अपरिवर्तित रहता है और कोई ईमेल नहीं भेजा जाता है।
वह पता जिस पर ईमेल जाता है। जब व्यक्ति के लिए कोई पता ज्ञात नहीं होता है तो एक खाली स्ट्रिंग: तब कोई ईमेल नहीं भेजा जा सकता है और preview_token भी खाली होता है। पुष्टि करते समय इसे email_address के रूप में पास करें।
"person@example.com"
recipient कहाँ से आता है। email_verification: वह पता जिसे व्यक्ति ने फ़्लो के ईमेल सत्यापन चरण में सत्यापित किया था। contact_details: सत्र निर्माण के समय contact_details में दिया गया पता। कोई पता न होने पर एक रिक्त स्ट्रिंग।
email_verification, contact_details, "email_verification"
वह From हेडर जिसके साथ ईमेल जाता है।
"Example App <no-reply@mail.example.com>"
sender का डिस्प्ले नाम वाला भाग।
"Example App"
sender का पता वाला भाग।
"no-reply@mail.example.com"
customer: ईमेल आपके एप्लिकेशन के सत्यापित प्रेषक डोमेन (व्हाइट लेबल) से जाता है। didit: यह Didit के अपने प्रेषक से जाता है।
customer, didit "customer"
विषय पंक्ति ठीक वैसे ही जैसे भेजी गई है।
"Your verification has been approved in Example App"
ईमेल का HTML ठीक उसी रूप में जैसा वह भेजा गया है, जिसमें उसका लोगो डेटा URL के रूप में एम्बेडेड है। इसे सैंडबॉक्स किए गए फ़्रेम में रेंडर करें, कभी भी सीधे अपने एप्लिकेशन DOM में नहीं।
"<!DOCTYPE html><html><body>...</body></html>"
एक संक्षिप्त पूर्वावलोकन के लिए व्यक्ति के Messages थ्रेड के अनुसार ईमेल के शब्द प्लेन टेक्स्ट के रूप में (HTML वही ईमेल रहता है जो व्यक्ति को प्राप्त होता है)।
"Verification Approved\n\nYour identity has been successfully verified with Acme Pay. No further action is needed on your part."
ईमेल जिस भाषा में लिखा गया है। यदि आपके द्वारा अनुरोधित email_language उपलब्ध नहीं है, तो अंग्रेज़ी (en) का उपयोग किया जाता है।
"en"
क्या send_email: true के साथ परिवर्तन की पुष्टि करने पर यह ईमेल भेजा जाता है। not_sent_reason सेट होने पर false।
true
पुष्टि करने पर कोई ईमेल क्यों नहीं भेजा जाएगा, या भेजे जाने पर null। status_unchanged: सत्र की यह स्थिति पहले से ही है, इसलिए अपडेट से कुछ नहीं बदलता और कुछ नहीं भेजा जाता। notification_emails_disabled: सत्र contact_details.send_notification_emails: true के बिना बनाया गया था, इसलिए contact_details में दिए गए पते पर कोई निर्णय ईमेल नहीं जाता है। no_recipient: व्यक्ति के लिए कोई पता ज्ञात नहीं है। sandbox: एक सैंडबॉक्स सत्र जिसके प्राप्तकर्ता ने सैंडबॉक्स ईमेल डिलीवरी का विकल्प नहीं चुना है, इसलिए भेजना केवल सिम्युलेट किया जाता है।
status_unchanged, notification_emails_disabled, no_recipient, sandbox, null null
इस सटीक ईमेल के लिए हस्ताक्षरित रसीद, जो 15 मिनट के लिए मान्य है। इसे Update Session Status में email_preview_token के रूप में पास करें। जब कोई प्राप्तकर्ता नहीं होता है तो यह एक खाली स्ट्रिंग होती है।
"eyJkaWdlc3QiOiI0ZjJhIn0:1uExAm:Pl3x4mpleS1gnatureValue000000000000000"