Create Bill of Exchange (BOE)

Creates, signs, stores, and prepares on-chain minting for a Bill of Exchange document.
This API:

  • validates request structure and required BOE fields,
  • signs the BOE as a W3C credential,
  • uploads raw + signed document to storage,
  • initializes mint transaction signing flow,
  • returns a WebAuthn signing URL (/sign?sessionId=...) to complete minting.

This API returns a redirect URL with sessionId to 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 key wrappedDocument, which contains the content of the .tt file.

If using MCP, enter shipperDomain, holderAddress, and beneficiaryAddress explicitly.

Body Params

Bill of Exchange minting request

billOfExchange
object
required
string
required
string
required
Headers
string

Unique key to ensure idempotency for API requests.

string

Unique external ID for tracking purposes, can be used for debugging and analytics.

Responses

401

Token is absent or invalid

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json