• Ethoca 申请状态查询
  • 功能介绍
    • 申请状态类型
  • 接口定义
  • 请求参数
  • 响应参数
    • data
    • content 中的对象
  • 请求及响应示例
  • 状态查询流程
  • 注意事项
    • 状态流转图
    • 查询流程

Ethoca 申请状态查询

本文档介绍如何查询 Ethoca 预警服务的申请状态。通过该接口，您可以随时了解您提交的 Ethoca 服务申请的审核进度和结果。

功能介绍

申请状态查询接口允许商户：

• 分页查询 Ethoca 预警服务申请的处理状态
• 根据多种条件筛选申请记录
• 查看申请的详细信息，包括申请时间、审核状态等
• 跟踪申请从提交到最终开通的全流程状态

申请状态类型

申请状态主要分为以下几种：

• PENDING_SUBMISSION - 待提交
• SUBMITTED_AND_PENDING_ENROLLMENT - 已提交待开通
• ENROLLING - 开通中
• ENROLLED - 已开通
• ENROLLMENT_FAILED - 开通失败
• SUBMITTED_AND_PENDING_DISENROLLMENT - 已提交待关闭
• DISENROLLING - 关闭中
• DISENROLLED - 已关闭

接口定义

GET

请求参数

名称	类型	长度	必填	签名	描述
merchantNo	String	20	Yes	Yes	商户号
id	String	64	No	Yes	申请单号
preDisputeService	String	32	No	Yes	预警服务，固定值：ETHOCA_ALERT
billDesc	String	128	No	Yes	商户账单描述
resellerSubMerchantId	String	20	No	Yes	代理运营商的子商户标识
enrollmentStatusList	String	32	No	Yes	报备状态，见申请状态类型
createTimeStart	String	32	No	Yes	创建时间起点，格式：yyyy-MM-dd HH:mm:ss
createTimeEnd	String	32	No	Yes	创建时间终点，格式：yyyy-MM-dd HH:mm:ss
updateTimeStart	String	32	No	Yes	更新时间起点，格式：yyyy-MM-dd HH:mm:ss
updateTimeEnd	String	32	No	Yes	更新时间终点，格式：yyyy-MM-dd HH:mm:ss
current	String	8	Yes	Yes	查询页码，从1开始
sign	String	/	Yes	No	签名字符串，请参阅签名接口

响应参数

名称	类型	描述
respCode	String	来自 Onerway 的响应码
respMsg	String	来自 Onerway 的响应信息
data	Object	响应数据。 请参阅对象 data

data

名称	签名	类型	描述
content	Yes	Array	申请记录列表
current	Yes	String	当前页码
size	Yes	Number	每页记录数
totalPages	Yes	Number	总页数
totalElements	Yes	Number	总记录数

content 中的对象

名称	签名	类型	描述
id	Yes	String	申请单号
merchantNo	Yes	String	商户号
preDisputeService	Yes	String	预警服务类型
billDesc	Yes	String	商户账单描述
resellerSubMerchantId	Yes	String	代理子商户号
enrollmentStatus	Yes	String	申请状态，见申请状态类型
notes	Yes	String	备注信息
comments	Yes	String	审核意见
createTime	Yes	String	创建时间，格式：yyyy-MM-dd HH:mm:ss
updateTime	Yes	String	更新时间，格式：yyyy-MM-dd HH:mm:ss
sign	No	String	签名字符串

请求及响应示例

GET

请求参数

{
  "billDesc": null,
  "createTimeEnd": "2025-03-27 16:08:28",
  "createTimeStart": "2025-03-20 16:08:28",
  "current": "1",
  "enrollmentStatusList": "",
  "id": "1905153967865069568",
  "merchantNo": "800209",
  "preDisputeService": "ETHOCA_ALERT",
  "resellerSubMerchantId": null,
  "sign": "22b4aac4b1f8c9f7f67386d9684a179c89317b9af385f750b213af53193402ba",
  "updateTimeEnd": null,
  "updateTimeStart": null
}

响应示例

{
    "respCode": "20000",
    "respMsg": "Success",
    "data": {
        "content": [
            {
                "id": "1905153967865069568",
                "merchantNo": "800209",
                "preDisputeService": "ETHOCA_ALERT",
                "billDesc": "eu deserunt sed consectetur",
                "resellerSubMerchantId": "19",
                "enrollmentStatus": "ENROLLING",
                "notes": null,
                "comments": "通过",
                "createTime": "2025-03-27 15:04:37",
                "updateTime": "2025-03-27 15:37:32",
                "sign": null
            }
        ],
        "current": "1",
        "size": 10,
        "totalPages": 1,
        "totalElements": 1
    }
}

状态查询流程

注意事项

注意事项

1. 申请状态查询接口支持分页查询，可通过current参数指定页码
2. 可通过日期范围、状态等条件筛选申请记录
3. 建议定期查询申请状态，以便及时了解申请进度
4. 当状态变为ENROLLED后，服务已成功开通
5. 如果状态为ENROLLMENT_FAILED，请根据comments中的审核意见修正问题后重新申请

最佳实践

1. 设置合理的查询时间范围，避免返回过多数据
2. 优先使用申请单号(id)进行精确查询
3. 对于代理商，可使用resellerSubMerchantId查询特定子商户的申请状态
4. 记录每次申请的id，以便后续跟踪

状态流转图

查询流程