Onerway
POST

Ethoca 服务开通申请

该接口用于提交 Ethoca 预警服务开通申请,并取得后续查询或变更状态所需的申请单号。

请求

merchantNo
Onerway 分配的商户号;代理运营商为子商户申请时,使用代理运营商自己的商户号发起请求。
示例:
preDisputeService
要开通的预警服务类型。
示例:
可选值
ETHOCA_ALERT
Ethoca 拒付预警服务;Ethoca 是 Mastercard 旗下预警网络,覆盖 Mastercard、American Express、Discover 等卡组织,部分地区支持 Visa。
约束
取值
本接口固定传 ETHOCA_ALERT。
billDesc
商户账单描述,将显示在持卡人银行账单上;建议使用商户实际经营名称并与收单实际展示保持一致,既便于持卡人和发卡行识别交易,也是 Ethoca 将预警匹配到对应商户的依据之一。
示例:
resellerSubMerchantId
条件:代理运营商为其管理的子商户申请服务时提供。
代理运营商的子商户标识。
示例:
约束
一致性
同一个代理运营商(merchantNo)可为多个子商户分别申请开通 Ethoca 服务;代理商应为每个子商户分配唯一 resellerSubMerchantId。
notes
申请备注,可填写特殊需求或补充说明。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/ethoca/agency-cw/enrollment/submit' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "billDesc": "EXAMPLE STORE US",
  "merchantNo": "replace_with_merchant_no",
  "notes": "Open Ethoca alert service",
  "preDisputeService": "ETHOCA_ALERT",
  "resellerSubMerchantId": "demo_sub_merchant_001",
  "sign": "{{SIGN}}"
}'

响应

respCode
响应码;20000 表示开通申请已成功提交受理,并不代表服务已开通。最终结果以查询 Ethoca 申请状态接口或 Ethoca 报备状态通知为准;其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
业务数据对象,包含本次服务开通申请的申请单号。

响应示例

示例代码暂不可用。

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