Process Transaction Event

info

Please note that this content is under development and is not ready for implementation. This status message will be updated as content development progresses.

Description

The processTransactionEvent service is responsible for processing a Transaction Event (DTE), issuing a Verifiable Credential (VC), uploading it to the Storage service, registering the link to the stored DTE with the Identity Resolver service, and managing DPPs in local storage associated with the event. It handles the entire lifecycle of creating and managing a transaction event, from data input to storage, resolution, and local data management.

Diagram

Example

{
  "name": "processTransactionEvent",
  "parameters": [
    {
      "vckit": {
        "vckitAPIUrl": "https://api.vckit.example.com",
        "issuer": "did:example:123456789abcdefghi"
      },
      "epcisTransactionEvent": {
        "context": ["https://www.w3.org/2018/credentials/v1", "https://gs1.org/voc/"],
        "type": ["VerifiableCredential", "EPCISTransactionEvent"],
        "renderTemplate": [
          {
            "type": "html",
            "template": "<div><h2>Transaction Event</h2><p>ID: {{transactionId}}</p></div>"
          }
        ],
        "dlrIdentificationKeyType": "gtin",
        "dlrLinkTitle": "Transaction Event",
        "dlrVerificationPage": "https://verify.example.com"
      },
      "storage": {
        "url": "https://storage.example.com/upload",
        "params": {
          "resultPath": "/url"
        }
      },
      "dlr": {
        "dlrAPIUrl": "https://dlr.example.com/api",
        "dlrAPIKey": "dlr-api-key-12345"
      },
      "identifierKeyPath": "/transactionId",
      "localStorageParams": {
        "storageKey": "transactionEvents",
        "keyPath": "/transactionId"
      }
    }
  ]
}

Definitions

Property	Required	Description	Type
vckit	Yes	Configuration for the VCKit service	VCKit
epcisTransactionEvent	Yes	Configuration for the EPCIS Transaction Event	Credential
storage	Yes	Configuration for storage service	Storage
dlr	Yes	Configuration for the Digital Link Resolver	IDR
identifierKeyPath	Yes	JSON path to the identifier in the credential subject	String
localStorageParams	Yes	Configuration for local storage management	LocalStorage