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

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

Text

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

Body

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

Body Example

{ 
    "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.

200 Return Payload

{
    "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.

404 Return Payload

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

404 Return Payload

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

400 Return Payload

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