These docs are for v1.7. Click to read the latest docs for v2.1.

Transfer Digital Passport

Allow your users to transfer digital passports to another wallet address.

Before you begin

As a brand, you wish to allow your users to transfer digital passports to another wallet address. To do so, our API generates the request ownership link.

⚠️

Every new transfer link is based on a new passphrase. That means old links will not work anymore.

Let's start 🚀

To trigger a transfer, use the wallet/transfer.

InputMandatoryTypeDescription
tokenIdNumberDigital passport identification number.
addressAddressWallet address of the target wallet.

📌

If the transfer is initiated by another user than the digital passport owner, the passphrase is mandatory.

curl -X POST "https://custodial.arianee.com/testnet/wallet/transfer" -H "accept: document" -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.." -H "Content-Type: application/json" -d "[87083218,\"0x1917408563f8F484E5C24d96a78002BF7D7F47e0\"]"

Result:

httpCodeDescription
200The transaction has been sent to the Blockchain. The end-user gets the digital passport ownership in a few seconds or minutes.
500Invalid wallet address.
{
	'receipt': {
		'transactionHash': '0x0357a3ae1bb40cf2fe3f503be00a6fa3ef74af8a65fb6b34c35f593b0e25e0ce',
		'transactionIndex': 0,
		'blockHash': '0x08db3469c3a1507989899567c787c332c62b13e488125eb0a926686a1667141c',
		'blockNumber': 28403214,
		'cumulativeGasUsed': 124480,
		'gasUsed': 124480,
		'effectiveGasPrice': '0xb2d05e000',
		'from': '0x563cf9dd4118accb137bc1c57e37ae9900c17ced',
		'to': '0x512c1fcf401133680f373a386f3f752b98070bc5',
		'contractAddress': None,
		'logs': [{
			'removed': False,
			'logIndex': 0,
			'transactionIndex': 0,
			'transactionHash': '0x0357a3ae1bb40cf2fe3f503be00a6fa3ef74af8a65fb6b34c35f593b0e25e0ce',
			'blockHash': '0x08db3469c3a1507989899567c787c332c62b13e488125eb0a926686a1667141c',
			'blockNumber': 28403214,
			'address': '0x512C1FCF401133680f373a386F3f752b98070BC5',
			'data': '0x',
			'topics': ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', '0x000000000000000000000000563cf9dd4118accb137bc1c57e37ae9900c17ced', '0x0000000000000000000000009d2f7cedf3757a4d3265bd93f5043a6971c234f6', '0x000000000000000000000000000000000000000000000000000000000a44bd66'],
			'id': 'log_169b9400'
		}, {
			'removed': False,
			'logIndex': 1,
			'transactionIndex': 0,
			'transactionHash': '0x0357a3ae1bb40cf2fe3f503be00a6fa3ef74af8a65fb6b34c35f593b0e25e0ce',
			'blockHash': '0x08db3469c3a1507989899567c787c332c62b13e488125eb0a926686a1667141c',
			'blockNumber': 28403214,
			'address': '0x3579669219DC20Aa79E74eEFD5fB2EcB0CE5fE0D',
			'data': '0x000000000000000000000000000000000000000000000000000000000a44bd66000000000000000000000000563cf9dd4118accb137bc1c57e37ae9900c17ced',
			'topics': ['0xa1fc15b295f9db85ce6f3e653f9a7e79e321f0828de5d7d09a5b0618bab64559'],
			'id': 'log_df7bd0c5'
		}],
		'logsBloom': '0x00000000000000080000000000000000000000000000000000000004000001000000000000000000000000000000000000000000000000000000000010100000000000000000001000000008000000000000000000000000000000000000001000000000000000000000000000000000000000000000000204000010000020000000000000008000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000802000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000004020010000000000000004000',
		'status': True,
		'type': '0x0'
	}
}

{
  'reason': 'invalid address (argument="address", value="0x563cf9dd4118accb137bc1c57e37ae9900c17ced999999999999999", code=INVALID_ARGUMENT, version=address/5.4.0)', 'code': 'INVALID_ARGUMENT', 'argument': '_to', 'value': '0x563cf9dd4118accb137bc1c57e37ae9900c17ced999999999999999'
}