Accepted

Genel Bakış

/v1/notify/accepted webhook'u, beneficiary KVHS'nin işlemi kabul edip ACCEPTED durumuna taşıdığını originator tarafına bildirir. Bildirim hem MAIN hem de BASIC protokollerinde gönderilir.

Tetiklenme Koşulları

• Beneficiary KVHS /v1/transactions/accept çağrısını tamamladı.
• İşlem durumu ACCEPTED olarak güncellendi.
• Originator KVHS, blockchain yayını ve varlık transferi için harekete geçmelidir.

Webhook Endpoint

POST /v1/notify/accepted

Payload

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "protocol": "MAIN",
  "status": "ACCEPTED",
  "originatorVASPdid": "did:web:originator.example",
  "beneficiaryVASPdid": "did:web:beneficiary.example"
}

Alanlar

Alan	Açıklama
transactionRef	ClearTX tarafından üretilen referans.
protocol	MAIN veya BASIC.
status	ACCEPTED.
originatorVASPdid	Originator KVHS DID.
beneficiaryVASPdid	Beneficiary KVHS DID.

Bu Webhook Ne Zaman Tetiklenir

Bu webhook aşağıdaki durumlarda tetiklenir:

1. Transaction bildirimi, alıcı KVHS tarafından kabul edildiğinde
2. Kabul işlemi, başarılı compliance doğrulamasından sonra gerçekleştiğinde
3. Originator KVHS'nın kabulden haberdar edilmesi gerektiğinde

Yanıt Gereksinimleri

• 200 OK: Kabul olayı işlendi.
• >=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/accepted", rawJson, (req, res) => {
  verifySignature(req);
  const event = JSON.parse(req.body.toString());
  if (event.status === "ACCEPTED") {
    scheduleBroadcast(event.transactionRef);
  }
  res.status(200).json({ status: "received" });
});