Recover Digital Passport

πŸ› οΈ

The recover feature works on the basis of the certificateId, our teams are working to provide this functionality with the productId in the near future.

Overview

Use cases

  • The product is declared and proven to be stolen or lost.
  • The product is returned.
  • The owner has lost the digital passport.

Under specific conditions and for a limited period, brands can reclaim/get back the ownership of a digital passport that is owned by another wallet.

Workflow

Let's start πŸš€

β›”

Limitation

You can recover one digital passport at once per API call.

⚠️

Each recovered digital passport spends 1 credit.

URL

To recover a digital passport in your wallet, use the api/recoverCertificate.

POST - https://{{nmpUrl}}/api/recoverCertificate

πŸ“Œ

The API is authenticated with the user rights required β†’ certRecover

Body

FieldTypeRequiredDescription
certificateIdStringβœ…Identification number of the digital passport to recover.
[
    650923746
]

Return Payload

The digital passport has been recovered. You'll get ownership back when the transaction is validated by the blockchain.

{
  "message": "Not yet in blockchain => transaction saved in transaction manager",
  "type": "transactionManager",
  "transactionId": "63b26e95053b19996d5398c8",
  "nonce": 58842,
  "chainId": 77,
  "from": "0x57F5111A7e997a7Ba63CC8976C92decbd86C1B08",
  "data": "0xb5aaa9d50000000000000000000000000000000000000000000000000000000026cc4ee2",
  "to": "0x512C1FCF401133680f373a386F3f752b98070BC5",
  "gasLimit": 500000,
  "gasPrice": "48000000000",
  "value": "0x00"

Errors

Status CodeSuccessError MessageAdditional Information
500falseThe NFT is not valid.The ID may be wrong.
500falseYour brand is not the passport issuer.-
{
    "message": "NFT is not valid!",
    "tokenId": 650923742324
}
{
    "message": "You are not the issuer!",
    "tokenId": 123456
}