Skip to main content
POST
Records the outcome of the transactions Build Transactions returned. Trusset reads the receipt from the chain and records only what it shows: the transaction must be mined, successful, sent by a wallet of your instance, and cover this customer’s wallet. The call confirms the step the onboarding waits for. Send kind with the kind you signed. A repeat of a confirmation that is already recorded then answers alreadyRecorded: true instead of being applied to the next step. After a confirmed registration the onboarding reads COMPLETED, or AWAITING_SIGNATURE again with ELIGIBILITY_ADMISSION when the profile has an eligibility register.

Path Parameters

string
required
The customer id, your externalId, the reference key or a wallet address of the customer.

Body Parameters

string
IDENTITY_REGISTRATION, ELIGIBILITY_ADMISSION or WHITELIST_ADMISSION: the kind you built and signed. Recommended on every call.
string
The hash of the transaction, 0x followed by 64 hex characters. For a registration it is the batchVerifyIdentities (or registerIdentity) transaction. Required for the two admission kinds.
array
For a registration: { id, txHash } for the residency claim transaction, with id the pendingId.
array
For a registration that renews an identity (operations reads update): { id, txHash } for the updateIdentity transaction, with id the pendingId.
string
For WHITELIST_ADMISSION: the whitelist this transaction listed the wallet on. Optional while exactly one whitelist is still open.

Response Fields

object
A registration answers 200 even when the chain could not be read or the transaction did not register the wallet. result.results[0].status then reads CHAIN_READ_UNAVAILABLE or NOT_REGISTERED_ON_CHAIN, and the onboarding stays AWAITING_SIGNATURE. Read onboarding.status, and confirm again or sign again.

Error Codes

A transaction that is not mined, reverted, sent to another contract or signed by a wallet that is not registered to your instance is refused with the code the confirmation of its kind documents.