ETH(以太坊)充值转账API接口文档

作者：

时间：1900/1/1 0:00:00

随着市场的发展和扩大，ETH能够在其内在价值和外在经济效应的双重加持下，获得比较稳定的发展和升值潜力。这得益于它的开创性获得众多开发者的青睐，同时得益于其大量的项目数量以及其底层区块链技术的安全性为人所称道。有需求的地方就有市场，这句话在加密市场依然适用。

不管是老牌交易所还是后期之秀的新兴交易所上线币种中ETH必不会缺席。那么eth充值接口、ethrpc接口对接、eth转账对接等等，又会给交易所对接带来哪些好处呢？对于交易所平台而言，上线ETH随之而来的就是ETH的流通与交易，首要解决的问题就是ETH的充提币功能，这是基础亦是核心，无法解决ETH充提币意味着交易所用户资金将无法流通，还有ethrpc接口对接、ethrpc接口开发、ethRPC开发、ethweb3接口、eth承兑商系统等，因此交易所钱包系统的战略性地位更为突出。

UdunWallet作为全球首家开放式企业钱包解决方案，以安全完善的技术重新定义数字资产钱包，为比特币、以太坊等100多种币种提供API接入；顶级私钥BOSS自主掌握，子私钥动态计算不触网，硬件加持，纯冷操作；多级财务审核策略，资产动向、操作日志一目了然；海量地址统一管理，余额一键自动归集；优盾钱包客户端全面支持Window、Mac、安卓、IOS系统。?点此立即试用?

以太坊是一个通用的全球性区块链，可以管理金融和非金融类型应用的状态。eth充值接口开发、eth对接、eth对接流程、eth归集、eth接口、eth接口对接、eth地址批量生成促成了一种新型的软件应用，真正的去中心化应用。将信任逻辑嵌入小程序里，运行在区块链上。与比特币相比，以太坊建立了一种新的密码学技术基础框架，在其上开发应用更加容易，并对轻客户端友好，同时允许应用共享一个可行的经济环境和可靠的区块链安全。以太坊在全球范围内激发了商业和社会创新，为前所未有的去中心化应用打开了大门。从长远来看，它所带来的改变将影响全球经济和控制结构。

以太坊也是区块链与智能合约的完美结合，是智能合约的完整解决方案，被设计成了一个通用的去中心化平台，拥有一套完整的、可以扩展其功能的工具，在P2P网络、加密、HttpClient等技术的支持下实现了一个类似于比特币的区块链。它通过工作量证明机制实现共识，由矿工挖矿，通过对新的网络协议的制定实现对区块链的同步等操作。在以太坊上可以任意编写智能合约，通过智能合约实现强大的功能，实现去中心化应用的开发。在以太坊上部署的智能合约运行在以太坊特有的虚拟机上，通过以太坊虚拟机和RPC接口与底层区块链进行交互。

对于交易所这种业务型系统，选择钱包的时候需要考虑的问题，应该是安全的同时也需要快速的业务对接。相关业务上的难点有：安全、跨链整合、庞大的数据量、还有其他的业务需求比如生成地址、地址管理、资金管理、交易记录管理、充提币及回调等等。这里我们可以了解下区块链钱包Udunwallet，它是目前国内最好用的企业级数字资产管理系统。API一键对接，支持当下多数主流币种、多资产多地址统一管理、用户提币初审+复核安全模式、系统代付自动放币、多员工多钱包多权限一键分配、资产交易查询、资金流动消息提醒等多种功能。它为ETH、BTC等100多种币提供API接入，实现ETH、BTC、USDT/ERC20等代币快速充提币、转账、支付、归集。

ethrpc接口对接、ethrpc接口开发、ethRPC开发、ethweb3接口、eth承兑商系统、eth承兑商系统开发、eth充币接口、eth充币接口对接、eth充币接口开发、eth充提币接口、eth充提币接口开发、eth充值接口、eth充值接口对接、eth充值接口开发、eth对接、eth对接流程、eth归集、eth接口、eth接口对接、eth地址批量生成。ETH(以太坊)充值转账API接口详细文档如下：

原文链接：https://www.uduncloud.com/developer/geteway-interface

1、目录

1.1、生成地址

1.2、提币

1.3、代付

1.4、交易回调

1.5、校验地址合法性

1.6、获取商户支持币种信息

2、接口明细

1、生成地址

1.1场景说明

请求指定币种地址,如要成功获取地址,需先存在钱包,且钱包支持该币种,?详情参看

1.2接口详情

1.2.1接口地址

接口详情

URL

请求方式

POST

1.2.2参数

1.2.2.1参数说明

参数

类型

是否必填

说明

备注

timestamp

String

是

时间戳

见?验签说明

nonce

String

是

随机数

见?验签说明

sign

String

是

签名

见?验签说明

body

String

是

消息内容

json字符串，格式如下

[

????{

?????"merchantId":"300015",

?????"coinType":520,

?????"callUrl":"http://localhost:8080/callBack"

????}

]

1.2.2.2body参数字段

body参数名

类型

是否必填

说明

merchantId

String

是

商户号

coinType

Integer

是

主币种编号，见?附录一

callUrl

String

是

回调地址，通过该接口创建的地址，以后关于该地址的充币信息会通过您指定的回调地址通知您。具体示例见?交易回调接口

walletId

String

否

钱包编号,默认根据主钱包生成地址

alias

String

否

地址别名

1.2.2.3示例

{

????"timestamp":1535005047,

????"nonce":10000,

????"sign":"a230def43c1a12b14393880a28d4e005",

????"body":""?

}

1.2.3返回状态码表

code

解释

200

成功

4005

非法参数

4001

商户不存在

4169

商户已禁用

4162

签名错误

4175

钱包编号错误

4017

商户没有创建钱包

4176

钱包未添加支持该币种

4166

商户没有配置套餐

4168

商户地址达到上限

4045

币种信息错误

-1

获取地址失败

1.3调取示例

1.3.1成功

{

????"data":{

????????"coinType":520,

????????"address":"0xbe4e3699cb870bc95365fe04a187dd279a651a58"

????},

????"message":"SUCCESS",

????"code":200

}

1.3.2失败

{

????"code":"4101",

????"message":"SIGN_MSG_ERROR"

}

2、发送提币申请

2.1场景说明

提币申请

2.2接口详情

2.2.1接口地址

接口详情

URL

请求方式

POST

2.2.2参数

2.2.2.1参数说明

参数

类型

是否必填

说明

备注

timestamp

String

是

时间戳

见?验签说明

nonce

String

是

随机数

见?验签说明

sign

String

是

签名

见?验签说明

body

String

是

消息内容

json字符串，格式如下

[

????{

????????"address":"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s",

????????"amount":"0.11",

????????"merchantId":"100109",

????????"mainCoinType":"144",

????????"coinType":"144",

????????"callUrl":"http://localhost:8080/mch/callBack",

????????"businessId":"15",

????????"memo":"10112"

????}

]

2.2.2.2body参数字段

body参数名称

是否必填

类型

说明

address

是

String

提币地址

amount

是

String

提币数量

merchantId

是

String

商户号

mainCoinType

是

String

主币种编号

coinType

是

String

子币种编号

callUrl

是

String

回调地址，通过该callUrl告知您该笔提币交易的状态,具体示例见?交易回调接口

businessId

是

String

业务id，必须保证该字段在系统内唯一，如果重复，则该笔审核钱包不会接收。

memo

否

String

备注,XRP和EOS，这两种币的提币申请该字段可选，起他类型币种不填

2.2.2.3示例

{

??"timestamp":1535005047,

??"nonce":100000,

??"sign":"6df1512ee650431632ce1541a6b064e1",

??"body":""?

}

2.2.3返回状态码表

code

解释

200

成功

4005

非法参数

4598

传入body中的list对象中的所有merchantId必须保持一致

4001

商户不存在

4169

商户已被禁用

4183

到账地址异常

4193

EOS金额小数点后超过4位长度

4034

未找到该币种信息

2.3.1成功

{

????"message":"SUCCESS",

????"code":200

}

2.3.2失败

{

????"code":"4101",

????"message":"SIGN_MSG_ERROR"

}

3、代付

3.1场景说明

代付,发送自动付款申请，未设置代付信息或代付失败则进入审核状态。

3.2接口详情

3.2.1接口地址

接口详情

URL

请求方式

POST

3.2.2参数

3.2.2.1参数说明

参数

类型

是否必填

说明

备注

timestamp

String

是

时间戳

见?验签说明

nonce

String

是

随机数

见?验签说明

sign

String

是

签名

见?验签说明

body

String

是

消息内容

JSON字符串，格式如下

[

??{

??????"address":"raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s",

??????"amount":"0.1",

??????"merchantId":"100146",

??????"mainCoinType":"144",

??????"coinType":"144",

??????"callUrl":"http://localhost:8080/callBack",

??????"businessId":"571001",

??????"memo":"10112"

??}

]

3.2.2.2body参数说明

body参数名称

类型

是否必填

说明

merchantId

String

是

商户号

address

String

是

提币地址

mainCoinType

String

是

主币种编号，见?附录一

coinType

String

是

子币种编号，见?附录一

amount

String

是

交易数量

callUrl

String

是

回调地址,提币结果将通过该地址进行回调，具体示例见?交易回调接口

businessId

String

是

业务id，必须保证该字段在系统内唯一，如果重复，则该笔提币钱包将不会进行接收

memo

String

否

备注,XRP和EOS，这两种币的提币申请该字段可选，起他类型币种不填

3.2.2.2示例

{

????"timestamp":1535005047,

????"nonce":100000,

????"sign":"e1bee3a417b9c606ba6cedda26db761a",

????"body":""

}

3.2.3返回状态码表

code

解释

200

成功

4005

非法参数

4001

商户不存在

4166

商户没有配置套餐

4169

商户已被禁用

4612

签名错误

4163

签名信息错误

569

无效的地址

571

已存在审核记录,将不再进行处理

581

非法提币金额

554

商户不支持该币种

3.3调取示例

3.3.1成功

{

????"message":"SUCCESS",

????"code":200

}

3.3.2失败

{

????"code":"4101",

????"message":"SIGN_MSG_ERROR"

}

4、交易回调接口

4.1场景说明

网关收到交易处理结果，调用商户提供的回调接口，通知商户具体变化信息。该接口网关发送给您指定的回调地址的内容，处理您的业务信息。分充值回调和提币回调，其中提币最多会进行两次回调

4.2接口详情

4.2.1接口地址

接口详情

URL

请求方式

POST

4.2.2参数

4.2.2.1参数说明

参数

类型

是否必填

说明

备注

timestamp

String

是

时间戳

见?验签说明

nonce

String

是

随机数

见?验签说明

sign

String

是

签名

见?验签说明

body

String

是

消息内容

JSON字符串，格式如下

{

????"address":"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW",

????"amount":"12345678",

????"blockHigh":"102419",

????"coinType":"206",

????"decimals":"8",

????"fee":"452000",

????"mainCoinType":"206",

????"status":3,

????"tradeId":"20181024175416907",

????"tradeType":1,

????"txId":"31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0",

????"businessId":"",//提币回调为提币接口传入的businessId，充币无值

????"memo":""

}

4.2.2.2body参数说明

body参数名称

类型

说明

address

String

地址

amount

String

交易数量，根据币种精度获取实际金额，实际金额=amount/pow(10,decimals)，即实际金额等于amount除以10的decimals次方

fee

String

矿工费，根据币种精度获取实际金额，实际金额获取同上

decimals

String

币种精度

coinType

String

子币种编号,见?附录一

mainCoinType

String

主币种编号,见?附录一

businessId

String

业务编号，提币回调时为提币请求时传入的，充币回调无值

blockHigh

String

区块高度

status

Integer

状态，见?回调接口状态说明

tradeId

String

交易流水号

tradeType

Integer

交易类型,见?回调接口交易类型说明

txid

String

区块链交易哈希

memo

String

备注，XRP和EOS，这2种类型币的充提币可能有值

4.2.2.2示例

{

????"timestamp":1535005047,

????"nonce":100000,

????"sign":"e1bee3a417b9c606ba6cedda26db761a",

????"body":"{"address":"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW","amount":"12345678","blockHigh":"102419","coinType":"206","decimals":"8","fee":"452000","mainCoinType":"206","status":3,"tradeId":"20181024175416907","tradeType":1,"txId":"31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0"}"

}

5、校验地址合法性

5.1场景说明

校验地址的合法性,添加地址、提币申请等场景时可先校验地址合法性，参看?校验规则

5.2接口详情

5.2.1接口地址

接口详情

URL

请求方式

Post

5.2.2参数

5.2.2.1参数说明

参数

类型

是否必填

说明

备注

timestamp

String

是

时间戳

nonce

String

是

随机数

sign

String

是

签名

body

String

是

消息内容

JSON字符串，格式如下

{

????"merchantId":200000,

????"mainCoinType":"206",

????"address":"DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW"

}

5.2.2.2body参数说明

body参数名称

类型

是否必填

说明

merchantId

Long

是

商户号

mainCoinType

String

是

主币种编号，见?附录一

address

String

是

需校验的地址

5.2.2.2示例

{

????"timestamp":1535005047,

????"nonce":100000,

????"sign":"e1bee3a417b9c606ba6cedda26db761a",

????"body":""

5.2.3返回状态码表

code

解释

200

成功

4005

非法参数

4162

签名错误

4165

地址不合法

5.3调取示例

5.3.1成功

{

????"code":200,

????"message":"SUCCESS"

}

5.3.2失败

{

????"code":4005,

????"message":"PARAM_ERROR"

}

6、获取商户支持的币种信息

6.1场景说明

获取商户支持的币种,以及余额

6.2接口详情

6.2.1接口地址

接口详情

URL

请求方式

POST

6.2.2参数

6.2.2.1参数说明

参数

类型

是否必填

说明

timestamp

String

是

时间戳

nonce

String

是

随机数

sign

String

是

签名

body

String

是

消息内容

6.2.2.2body参数说明

body参数名称

类型

是否必填

说明

merchantId

Long

是

商户号

showBalance

Boolean

是

是否查询余额，false不获取，true获取

6.2.2.3示例

{

????"timestamp":1535005047,

????"nonce":100000,

????"sign":"e1bee3a417b9c606ba6cedda26db761a",

????"body":"{"merchantId":"200032","showBalance":true}"

}

6.2.3返回状态码表

状态码

解释

200

成功

4005

body参数错误

6.3调取示例

6.3.1成功

{

????"code":200,

????"message":"SUCCESS",

????"data":[

????????{

????????????"name":"BTC",//币种别名

????????????"coinName":"Bitcoin",//币种全称

????????????"symbol":"BTC",//币种单位

????????????"mainCoinType":"0",//主币种类型

????????????"coinType":"0",//币种类型

????????????"decimals":"8",//币种精度

????????????"tokenStatus":"0",//0：主币1：代币

????????????"mainSymbol":"BTC",//主币种单位

????????????"balance":"0",//币种余额

????????????"logo-kcwr":"http://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/BTC.png"?//币种log地址

????????},

????????{

????????????"name":"ETH",//币种别名

????????????"coinName":"Ethereum",//币种全称

????????????"symbol":"ETH",//币种单位

????????????"mainCoinType":"60",//主币种类型

????????????"coinType":"60",//币种类型

????????????"decimals":"18",//币种精度

????????????"tokenStatus":"0",//0：主币1：代币

????????????"mainSymbol":"ETH",//主币种单位

????????????"balance":"0",//币种余额

????????????"logo-kcwr":"https://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/ETH.png"?//币种log地址

????????}

????]

}

6.3.2失败

{

????"code":4005,

????"message":"BGS_ILLEGAL_PARAMETER"

}

附录一

主币种编号

子币种编号

币种简称

币种英文名

币种中文名称

精度

BTC

Bitcoin

比特币

ETH

Ethereum

以太坊

USDT

TetherUSD

泰达币

520

CNT

测试币

DASH

达世币

133

ZEC

大零币

145

BCH

Bitcoincash

比特币现金

ETC

EthereumClassic

以太坊经典

LTC

莱特币

2301

QTUM

量子链币

502

GCC

GalaxyChain

合约地址

eth代币

根据代币具体情况而定

144

XRP

Ripple

瑞波币

194

EOS

柚子币

194

EOS

柚子币

2304

IOTE

2303

VDS

Vollar

Vollar币

回调接口状态说明

状态

说明

待审核

审核成功

审核驳回

交易成功

交易失败

回调接口交易类型说明

状态

说明

充币回调

提币回调

验签说明

为了保证商户传送到优盾的参数信息不被恶意篡改，网关为商户接口提供Md5加密摘要认证。商户可用基础加密参数：时间戳、随机数、签名密钥(商户唯一的APIKEY)、请求明文参数按指定顺序排列进行Md5加密，产生一个验签串sign，商户请求网关接口时，带上参数时间戳、随机数、请求明文参数、sign作为参数。网关拿到相应的参数以同样的方式进行签名验签。同理，网关请求商户也以同样的方式进行身份验证。

sign=md5(body+key+nonce+timestamp)

key为接口授权码APIKEY，由网关分配给商户，加密字段顺序不能错误

币种地址校验规则

主币种类型

币种简称

币种英文名称

币种中文名称

地址前缀

地址长度限制区间

BTC

Bitcoin

比特币

1或者3

ETH

Ethereum

以太坊

145

BCH

Bitcoincash

比特币现金

ETC

EthereumClassic

以太坊经典

LTC

Litecoin

莱特币

L或者M

508

503

NBTC

不限制

STO

证券型通证发行

不限制

DASH

达世币

2301

QTUM

量子链币

133

ZEC

ZCash

大零币

不限制

144

XRP

Ripple

瑞波币

加密货币交易所通过UdunWallet的充值、提币API接口一键接入，可以通过接口产生地址以及业务回调处理，接口安全稳定、接入简单快捷，独立网关授权和结算，安全控制业务，平台不触碰任何资产，实时监控网关运行状态。实现钱包创建、业务接入、地址生成、充币提币、交易查询、资金归集等功能。

UdunWallet，作为全球首家开放式企业级钱包解决方案。已安全运行800days+，每日出入金量2000万美金，注册用户2000+。以安全完善的技术重新定义数字资产钱包，为比特币、以太坊等100多种币种提供API接入；顶级私钥BOSS自主掌握，子私钥动态计算不触网，硬件加持，纯冷操作；多级财务审核策略，资产动向、操作日志一目了然；海量地址统一管理，余额一键自动归集。

防护技术上：

①API接口信息访问验签、基于HTTPS安全传输，拒绝被监听

②公钥衍生地址，私钥不上传、不触网、并通过二次加密托管在客户端

③HKS硬件加持，纯冷操作

④多钱包组合，充提分离

⑤钱包绑定电脑MAC地址，拒绝非认证设备访问

⑥冷热钱包分离，大额资产用冷钱包离线保存

保障技术上：

①员工操作权限管理员一键设置

②员工操作记录管理员一键查询

③员工只接触管理独立小额子钱包

④超额转出交易需管理员复核