Broadcasted

Genel Bakış

/v1/notify/broadcasted webhook'u, originator KVHS'nin blockchain işlemini yayınladığını hem originator hem de beneficiary taraflara bildirir. Webhook hem MAIN hem de BASIC protokollerinde tetiklenir ve zincir üstü txHash dahil olmak üzere işlem detaylarını içerir.

Tetiklenme Koşulları

• Originator KVHS /v1/transactions/broadcast çağrısını yaptı ve ClearTX hash bilgisini doğruladı.
• İşlem durumu BROADCASTED olarak güncellendi.
• Taraflar, yayınlanan transferi zincir üstünde izleyebilmelidir.

Webhook Endpoint

POST /v1/notify/broadcasted

Payload

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "protocol": "BASIC",
  "status": "BROADCASTED",
  "originatorVASPdid": "did:web:originator.example",
  "beneficiaryVASPdid": "did:web:beneficiary.example",
  "transactionBlockchainInfo": {
    "txHash": "0x3312...beef",
    "origin": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
    "destination": "0x8ba1f109551bD4328030126451Cec136"
  }
}

Alanlar

Alan	Açıklama
transactionRef	ClearTX referansı.
protocol	MAIN veya BASIC.
status	BROADCASTED.
originatorVASPdid	Originator KVHS DID.
beneficiaryVASPdid	Beneficiary KVHS DID.
transactionBlockchainInfo.txHash	Zincir üstü işlem hash'i.
transactionBlockchainInfo.origin	Gönderici adresi.
transactionBlockchainInfo.destination	Alıcı adresi.

Bu Webhook Ne Zaman Tetiklenir

Bu webhook aşağıdaki durumlarda tetiklenir:

1. Bir işlem başarıyla blockchain'e broadcast edildiğinde
2. Blockchain transaction hash'i mevcut olduğunda
3. KVHS'lerin başarılı broadcast hakkında bilgilendirilmesi

Yanıt Gereksinimleri

• 200 OK: Broadcast olayı kaydedildi.
• >=400: ClearTX yeniden denemeye devam eder.

Örnek Sunucu

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

app.post("/webhook/broadcasted", rawJson, (req, res) => {
  verifySignature(req);
  const event = JSON.parse(req.body.toString());
  trackOnChain(event.transactionBlockchainInfo.txHash);
  res.status(200).json({ status: "received" });
});