Received

Genel Bakış

/v1/notify/received webhook'u, ClearTX platformuna yeni bir işlem aktarıldığında tetiklenir. Webhook hem MAIN hem de BASIC protokollerinde kullanılır:

• MAIN akışında beneficiary tarafı, yalnızca işlem meta verilerini (varlık, tutar, adresler, protokol) alır.
• BASIC akışında payload, IVMS.101 uyumlu pii alanını da içerir; beneficiary tarafı kişisel bilgileri ilk bildirimde alır.

Tetiklenme Koşulları

• Originator KVHS /v1/transactions/initiate çağrısını tamamladı.
• ClearTX, işlemi beneficiary KVHS'ye iletmeye hazır.
• (BASIC) PII verisi şifrelenerek bildirime eklendi.

Webhook Endpoint

POST /v1/notify/received

Payload

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "protocol": "MAIN",
  "status": "RECEIVER_NOTIFIED",
  "originatorVASPdid": "did:web:originator.example",
  "beneficiaryVASPdid": "did:web:beneficiary.example",
  "transactionAsset": "BTC-BTC",
  "transactionAmount": "0.00320000",
  "transactionAssetDecimals": 8,
  "pii": {
    /* PII verisi */
  }
}

Alanlar

Alan	Açıklama
transactionRef	ClearTX tarafından üretilen benzersiz işlem referansı.
protocol	MAIN veya BASIC.
status	Her zaman RECEIVER_NOTIFIED.
originatorVASPdid	Originator KVHS DID.
beneficiaryVASPdid	Beneficiary KVHS DID.
transactionAsset	İşlemde kullanılan varlık çifti (ör. BTC-BTC).
transactionAmount	String olarak tutar; transactionAssetDecimals ile yorumlanır.
transactionAssetDecimals	Varlığın ondalık basamak sayısı. 0 ise human readable format kullanılır.
pii	IVMS.101 uyumlu kişisel verileri içerir.

Bu Webhook Ne Zaman Tetiklenir

Bu webhook başka bir KVHS'ten yeni bir transaction bildirimi alındığında tetiklenir.

Yanıt Gereksinimleri

• 200 OK: Bildirim işlendi.
• >=400: ClearTX yeniden deneme stratejisini uygular.