Create a TradeTrust-compliant electronic Promissory Note (ePN) for an End User organisation. This endpoint is called by the Integrating System to initiate ePN issuance. The ePN is issued against the organisation’s Token Registry and can be used for trade, settlement, or financing workflows.
How this fits in the Trade flow
- Called by the Integrating System
- Used after:
- Token Registry is deployed
- DNS configuration is validated
- Required registry roles (e.g., MINTER) are assigned
- Requires explicit End User approval
- Approval happens only via redirect URL and End User passkeys
Without End User approval, the ePN is not issued.
The Integrating System should store the created ePN identifiers and registry references in its own backend (BlockPeer is infra-only).
What happens next
- The Integrating System redirects the End User to
redirectUrl - The End User reviews ePN issuance details
- The End User approves issuance using passkeys
- The ePN is issued and recorded under the Token Registry
- The Integrating System stores the issued ePN details for future lifecycle actions
Important notes
- Issuance requires End User approval via redirect + passkeys
- Network transaction fees apply (paid by the End User-controlled account)
- BlockPeer does not store ePN business data or customer records
- The Integrating System remains the system of record
Common use cases
- Issuing trade promissory notes
- Creating receivable instruments
- Enabling trade finance or discounting workflows
- Digitising post-dated payment obligations
This API returns a redirect URL with
sessionIdto sign the transaction.
Use the GET endpoint/auth/session-response?sessionId=<sessionId>to retrieve the session result.
The response will include an object under the keywrappedDocument, which contains the content of the.ttfile.If using MCP, enter
shipperDomain,holderAddress, andbeneficiaryAddressexplicitly.
401Token is absent or invalid
