Confirmed Data

Genel Bakış

/v1/notify/confirmed-data webhook'u yalnızca MAIN protokolünde tetiklenir ve IVMS.101/PII bilgilerinin beneficiary KVHS'ye güvenli şekilde paylaşıldığını ifade eder. Bu bildirim, beneficiary tarafının CONFIRM adımını tamamlamasından hemen sonra gönderilir.

Tetiklenme Koşulları

• İşlem CONFIRMED durumuna geçti ve MAIN protokolü kullanılıyor.
• Originator tarafından sağlanan IVMS.101 verisi çözümlendi ve iletmeye hazır.
• Beneficiary KVHS, PII verisini işleyebilmesi için bildirim almalıdır.

Webhook Endpoint

POST /v1/notify/confirmed-data

Payload

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "protocol": "MAIN",
  "status": "CONFIRMED",
  "originatorVASPdid": "a5ac8098-7229-4d41-83cb-88c1bc343d91",
  "beneficiaryVASPdid": "did:web:beneficiary.example",
  "ivms101Data": {
    /* IVMS.101 uyumlu alanlar */
  }
}

Alanlar

Alan	Açıklama
transactionRef	ClearTX tarafından üretilen benzersiz işlem referansı.
protocol	Her zaman MAIN.
status	CONFIRMED.
originatorVASPdid	Originator KVHS DID.
beneficiaryVASPdid	Beneficiary KVHS DID.
ivms101Data	IVMS.101 uyumlu kişisel veriler.

Bu Webhook Ne Zaman Tetiklenir

Bu webhook aşağıdaki durumlarda tetiklenir:

1. MAIN protokolünde bir transaction bildirimi başlatıldıktan ve IVMS101 kişisel verileri başarıyla sağlandıktan sonra
2. Kişisel veriler, alıcı KVHS tarafından başarılı şekilde alındığında
3. Verilerin onaylı olarak karşı tarafa iletilmesi tamamlandığında

Yanıt Gereksinimleri

• 200 OK: PII güvenle işlendi/şifrelendi.
• >=400: ClearTX yeniden deneme stratejisini uygular.

Örnek Sunucu

const express = require("express");
const app = express();
const rawJson = express.raw({ type: "application/json" });

app.post("/webhook/confirmed-data", rawJson, (req, res) => {
  verifySignature(req);
  const event = JSON.parse(req.body.toString());
  handlePii(event.pii);
  res.status(200).json({ status: "received" });
});