Create Acceptance of Bill of Exchange

post

https://api.blockpeer.finance/api/blockpeer-trade/trade/registry/createAcceptanceOfBillOfExchange

Creates an Accepted Bill of Exchange verifiable credential from an existing Bill of Exchange document.
The API extracts bill details, attaches acceptance metadata (including drawee signature and acceptance date), signs the document using your DID keys for the provided domain, uploads it to storage, and returns the signed W3C credential.

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

Acceptance of Bill of Exchange request

billOfExchange

file

required

Bill of Exchange document file (.tt format only). Either billOfExchange or billOfExchangeBase64 is required.

billOfExchangeBase64

string

Bill of Exchange document file (.tt format only) in base64 format. Either billOfExchange or billOfExchangeBase64 is required.

walletId

string

required

Wallet ID of the acceptor

dns

string

required

DNS identifier for the trade registry

tokenRegistry

string

required

Token Registry address

remarks

string

required

Remarks for the acceptance

chain

string

enum

required

Defaults to STABILITY

Select the blockchain network

draweeSignature

file

required

Drawee signature image file (PNG, JPG)

Headers

Idempotency-Key

string

Unique key to ensure idempotency for API requests.

X-External-Id

string

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

Responses

401

Token is absent or invalid

201Acceptance of Bill of Exchange created successfully

400Invalid request body or missing fields

415Unsupported Media Type — billOfExchange must be a .tt file