Onerway
POST

变更 Ethoca 申请状态

该接口用于请求 Ethoca 申请状态流转,例如撤回待审核申请、关闭已开通服务,或在开通失败后重新提交申请。

请求

merchantNo
Onerway 分配的商户号;用于限定要变更的申请所属商户账户。
示例:
id
申请单号,用于指定要变更状态的 Ethoca 服务申请记录。
示例:
billDesc
商户账单描述,将显示在持卡人银行账单上;重新提交或补充申请信息时可提供。
示例:
resellerSubMerchantId
条件:代理运营商变更其子商户申请状态时提供。
代理运营商的子商户标识。
enrollmentStatus
指定要流转到的下一个申请状态;如果不填写,系统将根据 enrollmentEvent 自动处理状态流转。
可选值
PENDING_SUBMISSION
待提交:申请已创建,尚未提交审核。
SUBMITTED_AND_PENDING_ENROLLMENT
已提交,等待开通:申请已提交,正在排队等待审核与开通处理。
ENROLLING
开通中:审核通过,正在执行预警服务开通配置。
约束
规则
不同当前状态下可执行的状态变更由系统控制。
enrollmentEvent
申请状态变更事件,用于表达本次变更动作。
示例:
可选值
MERCHANT_WITHDRAW
商户撤回或停用:待审核状态下撤回尚未开通的申请;已开通状态下申请关闭、停用 Ethoca 服务。
MERCHANT_RESUBMIT
商户重新提交:开通失败或被拒后,参考 comments 修正问题后重新发起申请。
notes
状态变更说明,用于填写撤回原因、重新提交说明或补充材料说明。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/ethoca/agency-cw/enrollment/transition' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "billDesc": "EXAMPLE STORE US",
  "enrollmentEvent": "MERCHANT_RESUBMIT",
  "id": "replace_with_enrollment_id",
  "merchantNo": "replace_with_merchant_no",
  "notes": "Updated billing descriptor",
  "sign": "{{SIGN}}"
}'

响应

respCode
响应码;20000 表示请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
业务数据对象,包含本次状态变更是否被系统受理 / 处理成功。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。