账户管理

账户冻结对象

参数

类型

说明

id

String(64)

Adapay生成的账户冻结对象id

object

String(20)

账户冻结对象,account_freeze

created_time

String(10)

创建时的时间戳

prod_mode

String(4)

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

控制台 主页面应用的app_id

order_no

String(64)

请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一

trans_amt

String(14)

冻结金额, 必须大于0,保留两位小数点,如0.10、100.05等

member_id

String(64)

冻结用户的member_id,若为商户本身时,请传入0

unfreeze_flag

String(1)

是否已解冻标识:Y-已解冻,N-未解冻

status

String(16)

当前交易状态,参见 状态 说明

error_code

String(32)

错误码,详见 错误

error_msg

String(128)

错误描述,详见 错误

error_type

String(32)

错误类型,详见 错误

invalid_param

String(32)

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

创建账户冻结对象

实现对商户或者商户下用户的结算账户可用余额进行冻结操作。

请求参数

参数

类型

必填

描述

order_no

String(64)

Y

请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一

app_id

String(64)

Y

控制台 主页面应用的app_id

trans_amt

String(16)

Y

冻结金额, 必须大于0,保留两位小数点,如0.10、100.05等

member_id

String(64)

Y

冻结用户的member_id,若为商户本身时,请传入0

响应

成功时同步返回一个包含 账户冻结对象 的 JSON。

调用示例

Java

Map<String, Object> freezeParam = new  HashMap<String, Object>(4);
freezeParam.put("order_no", "1579163031383");
freezeParam.put("app_id", "app_XXXXXXXX");
freezeParam.put("trans_amt", "0.01");
freezeParam.put("member_id", "member_id_test");
Map<String, Object> freeze = SettleAccount.freeze(freezeParam);

成功响应

{
    "app_id": "app_XXXXXXXX",
    "trans_amt": "0.01",
    "created_time": "1579163032",
    "id": "002112020111717230410174704123849117696",
    "member_id": "member_id_test",
    "object": "account_freeze",
    "unfreeze_flag": "N",
    "order_no": "1579163031383",
    "status": "successed",
    "prod_mode": "true"
}

查询账户冻结对象列表

查询已发起的账户冻结交易,支持使用原冻结交易的请求订单号,以及时间范围查询。

请求参数

参数

类型

必填

说明

app_id

String(64)

Y

控制台 主页面应用的app_id

order_no

String(64)

N

原冻结交易的请求订单号

status

String(16)

N

查询交易状态:succeeded-成功,failed-失败,pending-处理中

page_index

int

N

当前页码,取值范围1~300000,默认值为1

page_size

int

N

页面容量,取值范围1~20,默认值为10

created_gte

String

N

查询大于等于创建时间戳

created_lte

String

N

查询小于等于创建时间戳;若不为空时,created_gte字段值不能为空且小于created_lte时间

响应

参数

类型

必填

说明

object

String(8)

Y

账户冻结对象列表,list

prod_mode

String(4)

Y

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

Y

控制台 主页面应用的app_id

order_no

String(64)

N

原冻结交易的请求订单号

has_more

boolean

Y

是否还有更多,true-是,false-否

account_freezes

List

N

账户冻结对象 的列表

status

String(16)

Y

当前交易状态,参见 状态 说明

error_code

String(32)

N

错误码,详见 错误

error_msg

String(128)

N

错误描述,详见 错误

error_type

String(32)

N

错误类型,详见 错误

invalid_param

String(32)

N

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> params = new HashMap<>();
params.put("app_id", "app_XXXXXXXX");
params.put("status", "succeeded");
params.put("page_index", "1");
params.put("page_size", "10");
params.put("created_gte", "1571466657929");
params.put("created_lte", "1571898657929");
Map<String, Object> result = SettleAccount.freezeList(params);

成功响应

{
    "account_freezes": [{
        "app_id": "app_XXXXXXXX",
        "created_time": "1604392443",
        "id": "002112020110316340210169618353981083648",
        "object": "account_freeze",
        "order_no": "order_no_123",
        "member_id": "member_id_test",
        "unfreeze_flag": "N",
        "trans_amt": "0.01",
        "status": "succeeded",
        "prod_mode": "true"
    }, {
        "app_id": "app_XXXXXXXX",
        "created_time": "1604367575",
        "id": "002112020110309393410169514048871583744",
        "object": "account_freeze",
        "order_no": "order_no_1234",
        "member_id": "member_id_test",
        "unfreeze_flag": "N",
        "trans_amt": "0.10",
        "status": "succeeded",
        "prod_mode": "true"
    }],
    "app_id": "app_XXXXXXXX",
    "has_more": false,
    "object": "list",
    "status": "succeeded",
    "prod_mode": "true"
}

账户解冻对象

参数

类型

说明

id

String(64)

Adapay生成的账户解冻对象id

object

String(20)

账户解冻对象,account_unfreeze

created_time

String(10)

创建时的时间戳

prod_mode

String(4)

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

控制台 主页面应用的app_id

order_no

String(64)

请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一

account_freeze_id

String(64)

Adapay生成的账户冻结对象id

status

String(16)

当前交易状态,参见 状态 说明

error_code

String(32)

错误码,详见 错误

error_msg

String(128)

错误描述,详见 错误

error_type

String(32)

错误类型,详见 错误

invalid_param

String(32)

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

创建账户解冻对象

实现对已冻结的交易进行全额解冻操作。

请求参数

参数

类型

必填

描述

order_no

String(64)

Y

请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一

app_id

String(64)

Y

控制台 主页面应用的app_id

account_freeze_id

String(16)

Y

Adapay生成的账户冻结对象id

响应

成功时同步返回一个包含 账户解冻对象 的 JSON。

调用示例

Java

Map<String, Object> unfreezeParam = new  HashMap<String, Object>(4);
unfreezeParam.put("order_no", "1579163031383");
unfreezeParam.put("app_id", "app_XXXXXXXX");
unfreezeParam.put("account_freeze_id", "002112020111717230410174704123849117696");
Map<String, Object> unfreeze = SettleAccount.unfreeze(unfreezeParam);

成功响应

{
    "app_id": "app_XXXXXXXX",
    "created_time": "1579163032",
    "id": "002112020111717230410174704123849117696",
    "account_freeze_id": "002112020111017580500172176218045927424",
    "object": "account_unfreeze",
    "order_no": "1579163031383",
    "status": "successed",
    "prod_mode": "true"
}

查询账户解冻对象列表

查询已发起的账户解冻交易,支持使用原解冻交易的请求订单号,以及时间范围查询。

请求参数

参数

类型

必填

说明

app_id

String(64)

Y

控制台 主页面应用的app_id

order_no

String(64)

N

原解冻交易的请求订单号

status

String(16)

N

查询交易状态:succeeded-成功,failed-失败,pending-处理中

page_index

int

N

当前页码,取值范围1~300000,默认值为1

page_size

int

N

页面容量,取值范围1~20,默认值为10

created_gte

String

N

查询大于等于创建时间戳

created_lte

String

N

查询小于等于创建时间戳;若不为空时,created_gte字段值不能为空且小于created_lte时间

响应

参数

类型

必填

说明

object

String(8)

Y

账户解冻对象列表,list

prod_mode

String(4)

Y

是否prod模式,true是prod模式,false是mock模式

app_id

String(64)

Y

控制台 主页面应用的app_id

order_no

String(64)

N

原解冻交易的请求订单号

has_more

boolean

Y

是否还有更多,true-是,false-否

account_unfreezes

List

N

账户解冻对象 的列表

status

String(16)

Y

当前交易状态,参见 状态 说明

error_code

String(32)

N

错误码,详见 错误

error_msg

String(128)

N

错误描述,详见 错误

error_type

String(32)

N

错误类型,详见 错误

invalid_param

String(32)

N

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> params = new HashMap<>();
params.put("app_id", "app_XXXXXXXX");
params.put("status", "succeeded");
params.put("page_index", "1");
params.put("page_size", "10");
params.put("created_gte", "1571466657929");
params.put("created_lte", "1571898657929");
Map<String, Object> result = SettleAccount.unfreezeList(params);

成功响应

{
    "account_unfreezes": [{
        "app_id": "app_XXXXXXXX",
        "created_time": "1604392443",
        "id": "002112020110316340210169618353981083648",
        "account_freeze_id": "002112020111017580500172176218045927424",
        "object": "account_unfreeze",
        "order_no": "order_no_123",
        "status": "succeeded",
        "prod_mode": "true"
    }, {
        "app_id": "app_XXXXXXXX",
        "created_time": "1604367575",
        "id": "002112020110309393410169514048871583744",
        "account_freeze_id": "002112020111018124600172179913940783104",
        "object": "account_unfreeze",
        "order_no": "order_no_1234",
        "status": "succeeded",
        "prod_mode": "true"
    }],
    "app_id": "app_XXXXXXXX",
    "has_more": false,
    "object": "list",
    "status": "succeeded",
    "prod_mode": "true"
}