Transfer Digital Passport

Workflow

Let's start 🚀

💡
If the digital passport has not been minted yet, it is automatically minted when operating the transfer.

URL

Required rights: admin

To transfer an NFT, use /productManagement/product/:productId/transfer.

POST - https://{{nmpUrl}}/productManagement/product/:productId/transfer

Body

Field	Type	Required	Description
`viewKey`	String	✅	The digital passport view key (also known as a passphrase).
`address`	String	❌	Recipient address. If there is no address, the API takes the issuer's address.

{ 
    "viewKey": "da1i2whtq7zd",
    "address": "0x8Ce250a8D46E8f961C832908c9E604FE9Eb7952B"
}

Return Payload

Field	Type	Description
`success`	Boolean	Indicates whether the request was successful.
`message`	String	Transaction is waiting to be sent to the blockchain.

{
    "success": true,
    "data": "Transaction is waiting to be sent to the blockchain"
}

Errors

Status Code	Success	Code	Error Message
`400`	`false`	`npm.productManager.product.incorrectPayload`	Some parameters of your payload are incorrect. See details.
`404`	`false`	`npm.productManager.product.ProductGroupIdDoesNotExist`	Product group ID does not exist.
`404`	`false`	`npm.productManager.product.productIdDoesNotExists`	Product ID does not exist.
`400`	`false`	`npm.productManager.product.alreadyMinted`	A digital passport is already minted.
`404`	`false`	-	The view key is not correct.
`400`	`false`	-	Wrong wallet address.
`400`	`false`	`nmp.productManager.product.productGroupNotMinted`	ProductGroup is not minted.
`500`	`false`	`npm.productManagement.product.UnknownError`	An unknown error has occurred.

{
    "message": "productId grd1111 does not exists",
    "code": "nmp.productManagement.PRODUCT_ID_NOT_EXISTS"
}

{
    "success": false,
    "data": "Product not found"
}

{
    "errors": [
        {
            "value": "0x8Ce250a86E8f961C832908c9E604FE9Eb7952B",
            "msg": "The address must be an ethereum address",
            "param": "address",
            "location": "body"
        }
    ]
}