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

Claim Digital Passport

Allow your users to claim a digital passport and store it in their wallet.

Before you begin

As a brand, you wish to distribute digital passports. To get ownership, your users must claim these digital passports which will be stored in their wallet.

We manage wallet creation based on blockchain transactions. Your users will get their own secured wallet for the first digital passport claimed.

⚠️

We do not recommend to create wallet for all users if they do not own a digital passport.

Let's start 🚀

To fetch the authenticity, use the wallet/requestCertificateOwnership.

InputMandatoryTypeDescription
certificateIdNumberDigital passport identification number.
passphraseStringDigital passport access passphrase.
curl -X POST "https://custodial.arianee.com/testnet/wallet/requestCertificateOwnership" -H "accept: application/json" H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..." -H "Content-Type: application/json" -d "[87083218,\"qoy7bdpri6me5\"]" 

Result:

httpCodeDescription
200The digital passport transaction is returned.
500The digital passport is not claimable.
{
  "transactionHash": "0x0fae8093ceeac6ab0bed395c54b3acd9e0f825e3e7662705d3a86bb3aa9ece31",
  "transactionIndex": 0,
  "blockHash": "0xf71c02e2c45aecdd5456869bdbc5be1bc4aace39b8c80eb3ff2dc40e87cceeee",
  "blockNumber": 26833196,
  "cumulativeGasUsed": 182006,
  "gasUsed": 182006,
  "effectiveGasPrice": "0x59682f000",
  "from": "0xe522d3218602e6a783dabfd77993d4bf3e9af339",
  "to": "0x82890cedcb8eb0cdc229ac7b8fdd39f93700c854",
  "contractAddress": null,
  "logs": [
    {
      "removed": false,
      "logIndex": 0,
      "transactionIndex": 0,
      "transactionHash": "0x0fae8093ceeac6ab0bed395c54b3acd9e0f825e3e7662705d3a86bb3aa9ece31",
      "blockHash": "0xf71c02e2c45aecdd5456869bdbc5be1bc4aace39b8c80eb3ff2dc40e87cceeee",
      "blockNumber": 26833196,
      "address": "0x512C1FCF401133680f373a386F3f752b98070BC5",
      "data": "0x",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000135935c83acf4e0c1aa0bd948dc710ec76b478b0",
        "0x000000000000000000000000e522d3218602e6a783dabfd77993d4bf3e9af339",
        "0x000000000000000000000000000000000000000000000000000000000cfc3371"
      ],
      "id": "log_039b1067"
    },
    {
      "removed": false,
      "logIndex": 1,
      "transactionIndex": 0,
      "transactionHash": "0x0fae8093ceeac6ab0bed395c54b3acd9e0f825e3e7662705d3a86bb3aa9ece31",
      "blockHash": "0xf71c02e2c45aecdd5456869bdbc5be1bc4aace39b8c80eb3ff2dc40e87cceeee",
      "blockNumber": 26833196,
      "address": "0x3579669219DC20Aa79E74eEFD5fB2EcB0CE5fE0D",
      "data": "0x000000000000000000000000000000000000000000000000000000000cfc3371000000000000000000000000135935c83acf4e0c1aa0bd948dc710ec76b478b0",
      "topics": [
        "0xa1fc15b295f9db85ce6f3e653f9a7e79e321f0828de5d7d09a5b0618bab64559"
      ],
      "id": "log_2120d566"
    },
    {
      "removed": false,
      "logIndex": 2,
      "transactionIndex": 0,
      "transactionHash": "0x0fae8093ceeac6ab0bed395c54b3acd9e0f825e3e7662705d3a86bb3aa9ece31",
      "blockHash": "0xf71c02e2c45aecdd5456869bdbc5be1bc4aace39b8c80eb3ff2dc40e87cceeee",
      "blockNumber": 26833196,
      "address": "0xB81AFe27c103bcd42f4026CF719AF6D802928765",
      "data": "0x0000000000000000000000000000000000000000000000000000000000000014",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000082890cedcb8eb0cdc229ac7b8fdd39f93700c854",
        "0x000000000000000000000000a79b29ad7e0196c95b87f4663ded82fbf2e3add8"
      ],
      "id": "log_cedf0c77"
    },
    {
      "removed": false,
      "logIndex": 3,
      "transactionIndex": 0,
      "transactionHash": "0x0fae8093ceeac6ab0bed395c54b3acd9e0f825e3e7662705d3a86bb3aa9ece31",
      "blockHash": "0xf71c02e2c45aecdd5456869bdbc5be1bc4aace39b8c80eb3ff2dc40e87cceeee",
      "blockNumber": 26833196,
      "address": "0xB81AFe27c103bcd42f4026CF719AF6D802928765",
      "data": "0x000000000000000000000000000000000000000000000000000000000000000a",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000082890cedcb8eb0cdc229ac7b8fdd39f93700c854",
        "0x000000000000000000000000e522d3218602e6a783dabfd77993d4bf3e9af339"
      ],
      "id": "log_8b918bbd"
    }
  ],
  "logsBloom": "0x00000000000000080000400000000000000000100000000000000004000000000000000000000000000000000000000000000000000000000000000010040020000000000000001000000008200000000000000000000000000000000000000000000000000800000000000000000000000000000000000004000010000020000008000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000002000000000000000000000000001000100000000000000000000000000000000000008800100000100000000000004044020014000000000000800000",
  "status": true,
  "type": "0x0"
}
[
  {
    "isTrue": false,
    "code": "token.requestable",
    "message": "certificate is not requestable"
  }
]