custodyAccount

托管账户post请求(聪相关）

1.账户的验证

本小节API使用需提前获取账户认证，认证方法请查看以下page:

Authentification-app

APP端需要获取token作为账户标识。并在后面每一个请求头中放入token

请求头：

APP端：
key：Authorization  value: Bearer token

2.申请一张发票

POST:/custodyAccount/invoice/apply

该接口是为用户申请一张指定数额发票。 需要注意的是，只有用户调用过一次申请发票的接口后，服务器端才会激活该用户的托管账户功能。在此之前，调用托管账户相关的其他功能调用可能会失败。这个问题会在上线托管资产时优化。

请求体：

{
    "amount": 500,
    "memo" : "it's a test invoice"
}

amount:数量
memo：发票中的附言

响应：

{
    "invoice": "lnbcrt1300n1pndcs08pp5y2zxgqleacgw8cm5mvfyvz8zc282t090myhpdtlg3npqnmjnw37sdqld96zwueqvys8getnwssxjmnkda5kxegcqzzsxqyz5vqsp58sllafzwk7tzag6x20794uw2ry6jck0jhgw6tx3etlf5dpt9nurs9qxpqysgqer74a5zprad878xh5zsg6sffhd66px4yp52sg2leufmuu4mu47e8zymfmf6wek9d9yxj2qy4mdrhfm2vau4afxrkxvy8pm8aml9yztcq0f9ahe"
}

invoice:申请的发票字符串

3.查询当前账户的所有发票

POST:/custodyAccount/invoice/queryinvoice

请求体：

{
    "asset_id": "00"
}

asset_id：默认使用“00”，查询比特币

响应体：

{
    "invoices": [
        {
            "invoice": "lnbcrt1300n1pndcs08pp5y2zxgqleacgw8cm5mvfyvz8zc282t090myhpdtlg3npqnmjnw37sdqld96zwueqvys8getnwssxjmnkda5kxegcqzzsxqyz5vqsp58sllafzwk7tzag6x20794uw2ry6jck0jhgw6tx3etlf5dpt9nurs9qxpqysgqer74a5zprad878xh5zsg6sffhd66px4yp52sg2leufmuu4mu47e8zymfmf6wek9d9yxj2qy4mdrhfm2vau4afxrkxvy8pm8aml9yztcq0f9ahe",
            "asset_id": "00",
            "amount": 130,
            "status": 0
        },
        {
            "invoice": "lnbcrt1300u1pnghpwtpp5yyhjv3f8f8u5s0tzxh9cqamcjc4a7dwd4a7rdvq4t5ypqpk4gj9sdqld96zwueqvys8getnwssxjmnkda5kxegcqzzsxqyz5vqsp5zxg0wmdcvddvnlds6npsmldfl5wprfk38wtsye6cp5a9z6mns4ps9qyyssqzv2pjsuwn35tsgm5m7kkaag2z897d8wfxspm09fg5yakcy3vyrm4ev2lr5wzpfs4tqa7qz2pku0ny7hnyexrf89wt7fct2942snk6xgplj55dx",
            "asset_id": "00",
            "amount": 130000,
            "status": 2
        }
    ]
}

invoice：该条记录发票对应的字符串
asset_id: "00"代表比特币
amount：该条记录发票对应的数量
status：这条发票状态（0：未支付 1：已被支付 2：已失效 3：已被支付）

4.查询余额

弃用，使用coustodyAccount第8条

POST:/custodyAccount/invoice/querybalance

请求体：

无

响应体：

{
    "balance": 0
}

balance：比特币余额，单位：聪

5.支付发票

POST:/custodyAccount/invoice/pay

请求体：

{
    "invoice":"lnbcrt5u1pndj6dxpp5gjtcpp0ufrryr6ujf4kfuy7ehm35u0zer56menhzx9rpcjfl8ujqdqld96zwueqvys8getnwssxjmnkda5kxegcqzzsxqyz5vqsp50vrjpl3049w6luwednq7hqhnd5k2408ejs9phmyr9tquqz45x69q9qxpqysgqzn8nj6qshte3d4jwmj9ca8nzq7ztxhd2qlygq333r6hhk8ggnetjr6er5afekf60m9cgtl57fda27y4ufsd9y9xjqspgev5vfvl6m5sqjaz6c9",
    "feeLimit": 0
}

invoice：发起支付的目标发票字符串
feeLimit：费用限制（填0为使用默认值，目前app端不开放给用户选择，统一为0）

响应体：

{
    "payment":"success",
}

payment：执行成功标识

6.查询托管账户的交易记录

POST:/custodyAccount/invoice/querypayment

请求体：

{
    "asset_id": "00",
    "page":1,//页数
    "page_size":2,//页面大小
    "away":0//入账0，出账1
}

asset_id：默认使用“00”，查询比特币

响应体：

{
    "payments": [
        {
            "timestamp": 1722846300,
            "bill_type": 1,
            "away": 1,
            "target": "lnbcrt15u1pntprzjpp5qkmfsfqwlad5pm08ygfjglvka7gyky3xaytjq8rakm4f4xcglrgqdqud9h8getjdeskcgr5wfskuumxv4eqcqzzsxqyz5vqsp542snjzzu9w0yuhxc3vrtpfzpp3mgm7vt4tzd46rpjurrrrxsm6gs9qyyssqd2vccrkrc48rgd9jhzlt2sdhnjn6yn78r3ctx4kamjaj47lx2p93wt6cr7hkc4ftqflwrkn0sqa042va8haauyrgpx7n4ma7n3u333qqpvy99v",
           //原“invoice”字段
             "amount": 1500,
            "asset_id": "00",
            "state": 1,
            "fee": 0
        },
        {
            "timestamp": 1722846230,
            "bill_type": 1,
            "away": 1,
            "target": "lnbcrt15u1pntpzlapp5h5f8hyqteqp6d3j9psuewjmaw49qkvn2kx629zhqm7pmdptfnrzqdqud9h8getjdeskcgr5wfskuumxv4eqcqzzsxqyz5vqsp5ekcydavjf33chvvevus46zsalld5dcg3v5w5ydq57g75csp5anps9qyyssqxscrud3qxyxc83s2ugch2hqfkddgk5sye6h3mlpynkr58htm0pjk5xx7mfu57f4fxf6kl9aqhweygtmwtxe82d9yqnr3j5dy64x9xcqpp3s56k",
            "amount": 1500,
            "asset_id": "00",
            "state": 1,
            "fee": 100
        }
    ]
}

timestamp：时间
bill_type：交易类型
away：0 转入 1 转出
target:关联发票
amount：金额
asset_id：币种类型。00为比特币
state:状态，0 处理中，1 成功，2 失败，3成功
fee：交易产生的额外费用

invoice：关联发票(弃用，更变为target）

更新：invoice字段变更为target，未来版本删除invoice

更新:8/5新增fee字段

7.解码发票

POST：/custodyAccount/invoice/decodeinvoice

请求体：

{
    "invoice": "lnbcrt200u1pnw85vhpp5cyhc3vrqeqrxyxhk72m96mq6zmay4ge465lzun9zrsvu25ujez8sdqld96zwueqvys8getnwssxjmnkda5kxegcqzzsxqyz5vqsp5l48sjaak3asx7234wsyrp2pmkawg52c9303pwg3a49sve8f2hcts9qxpqysgqhlm9pam4ksk2zlkuu4nm35ytzpmgny0rq6cwjxjgj890sh3hm53ns2cz32yl2u2pgameu74u393ca75f0zmvw2m7ywe9zgu4ekmr3ksqlhwwlc"
}

invoice：发票字符串

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "amount": 20000,
        "timestamp": 1726206359,
        "expiry": 86400,
        "memo": "it's a test invoice"
    }
}

amount:发票价值金额
timestamp：发票创建时间
expiry：发票有效期
memo:附言

8.查询余额

POST：/custodyAccount/balance

请求体：

{
    "assetId":"00" //00为比特币，其他资产填资产id
}

响应体：

{
    "totalBalance": 920000,
    "unlockedBalance": 920000,
    "lockedBalance": 0
}

totalBalance：总余额
unlockedBalance：活动账户
lockedBalance：冻结账户

9.查询所有btc及资产余额列表

Post：/custodyAccount/getAssetBalanceList

请求体：

无

响应体：

{
    "success": true,
    "error": "",
    "code": 200,
    "data": [
        {
            "assetId": "00",
            "amount": 111141,
            "prices": 0
        },
        {
            "assetId": "22222222222222222222",
            "amount": 1341,
            "prices": 0
        },
        {
            "assetId": "ac2d4d2c31f982ec5fe550f92d3bb961a30b50e67b26b4115692b8a65e7a2538",
            "amount": 102462,
            "prices": 0
        }
    ]
}