接口参考

接口说明

查看发卡 API 的公共请求 Header、响应结构、币种与时间戳规则、响应码。

接入发卡 API 前，请先阅读本页公共规则。除非具体接口页另有说明，发卡商户 API 均使用 /api/v1/merchant base path 下的 POST 请求。

Header	Type	Required	说明
`Content-Type`	String	Yes	使用 `application/json;charset=UTF-8`。
`ApiKey`	String	Yes	Onerway 分配的发卡 API 商户身份凭据。

币种值使用 ISO 4217 国际标准。

Long 类型时间戳均为 UTC 时间戳。查询参数默认使用秒，除非具体接口页另有说明；操作、结算、授权和交易事件时间可按毫秒返回。

当 HTTP 状态码不是 200 时：

HTTP 状态码	说明
`401 Unauthorized`	API 凭据无效。
`403 Forbidden`	触发 IP 白名单限制或 API 权限不足。

当 HTTP 状态码为 200 时，请读取业务响应码：

Code	说明
`20000`	成功。
`40000`	参数错误。
`80000`	内部服务错误，请联系 Onerway。
`80001`	持卡人不存在。
`80002`	持卡人邮箱已存在。
`80003`	持卡人所属商户号不正确。
`80004`	商户状态无效。
`80005`	商户未开通发卡业务。
`80006`	商户账户不存在。
`80007`	商户余额不足。
`80008`	充值金额超过最大限制。
`80009`	充值金额低于最小限制。
`80010`	数据重复。
`80011`	持卡人卡数量达到限制。
`81000`	未授权商户。
`81001`	业务不存在。
`40004`	系统异常：`NoHandlerFoundException`。
`40005`	系统异常：`HttpRequestMethodNotSupportedException`。
`40013`	系统异常：`HttpMessageNotReadableException`。
`40015`	系统异常：`HttpMediaTypeNotSupportedException`。

接入准备

调用发卡 API 前，请仔细阅读下面流程。

创建卡片

为指定持卡人和卡产品创建预付虚拟卡。