Download Transaction Receipt

Generate a PDF receipt for a SIL transaction and return it as a Base64 string. The receipt is tamper-proof and carries the tenant's branding (logo, primary colour).

This follows the same pattern as DownloadCoreTransactionReceiptCommand used in the core BPM channel.

Cmd: SITDownloadTransactionReceiptCommand
Permission: bnk_sit_view_transactions

Request

Provide one of sitTransactionId or transactionReference:

{
  "cmd": "SITDownloadTransactionReceiptCommand",
  "data": {
    "sitTransactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "cmd": "SITDownloadTransactionReceiptCommand",
  "data": {
    "transactionReference": "WDR-20260427-0001"
  }
}

Field	Type	Required	Notes
sitTransactionId	guid	one of	GUID of the SIL transaction
transactionReference	string	one of	e.g. WDR-20260427-0001

Response

{
  "isSuccessful": true,
  "statusCode": "00",
  "message": "Transaction receipt generated successfully.",
  "data": {
    "base64Receipt": "JVBERi0xLjQKJcfsj6IK...",
    "docType": ".pdf"
  }
}

Field	Description
base64Receipt	Base64-encoded PDF bytes. Decode and render / download on the client.
docType	Always .pdf

Client-side usage (JavaScript)

const bytes = atob(data.base64Receipt);
const blob = new Blob(
  [Uint8Array.from(bytes, c => c.charCodeAt(0))],
  { type: 'application/pdf' }
);
const url = URL.createObjectURL(blob);
// open in new tab or trigger download
window.open(url);

Receipt contents

The generated PDF includes:

Section	Fields
Header	Tenant logo, company name, "Transaction Receipt" title
Transaction details	Reference, type, date, amount, currency, status, narration
Ledger legs	Account number, Dr/Cr, amount, currency, branch per entry
Footer	Tamper-proof signature bar (tenant primary colour)

Error cases

Status	Cause
400	Neither sitTransactionId nor transactionReference supplied
404	Transaction not found for this tenant