欢迎使用MODEN的API文档。从初创企业到企业业务，MODEN将帮助您从头到尾管理客户的体验。

在本文档中，您将找到教程和完整的API参考。

要求

在开始之前您需要先开通“商户账户”,申请开通我们会在48小时内进行审核。审核通过后您可以通过下方步骤获取APP ID 和 密钥：

1. 登录账户
2. 导航栏右上角”我的工作台“
3. 设置中查看 APP ID和密钥

基本网址和环境

所有端点都是REST ful:

在沙箱环境，让您在不影响实时数据运行测试。

在沙箱测试完成后，确认没问题后只要把URL更改成“生产” url即可投入正式环境。

身份认证

要使用身份认证，您需要app id和 secret。

1.编码您的app id 和 secret

使用Base64对您的app id 和  secret进行编码，不带空格，以冒号分割。

// 例子
$ echo -n myapp_id:secret | base64
bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK

2.创建授权标题

将步骤1中的值作为内容，并在前面添加字符串”Basic”。

// 例子
Authorization: Basic bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK

3.发送请求

在API请求的授权标头中包含步骤2中的字符串。

// 例子
curl -X POST https://api.modenpay.io/pay/inquire/wallet \
	-H 'Accept: application/json' \
	-H 'Authorization: Basic bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK'

创建第一个请求

一个开始熟悉我们的API的好地方是通过向服务端发送“查询余额”请求。

如果请求成功将返回对应json信息。

通过 POST 向服务端发送请求。

示例：

curl -X POST https://api.modenpay.io/pay/inquire/wallet \
	-H 'Accept: application/json' \
	-H 'Authorization: Basic <Your Basic Auth>'

如果一切顺利您向获得一个状态为 200 的响应

{
	"status" : "success",
	"data" : {
		"totalAssets" : 0.000000,
		"coin" : "USDT"
	}
}

当然，或许您也会得到一个状态为 412 的响应

{
	"status" : "fail",
	"code" : 10000,
	"message" : "xxxxxxx"
}

这是一个错误的json返回，您可以根据错误 code 代码查找对应错误信息。错误代码参考表

下一步

当您成功发送第一个请求后，就可以根据您的需求进行下列工作了。

• 创建支付
• 查询订单状态
• 查询余额
• 查询当前系统(动态)支持的货币。
• 查询当前系统(动态)支持的支付方式。
• 查询API系统状态