Custom版本 1.0.0
创建报关单
PUT
https://pay.globepay.co/api/v1.0/customs/partners/{partner_code}/declare/report/{client_report_id}用于商户提交海关需要的订单附件信息。仅支持微信和支付宝，微信只支持一个月内的支付订单进行报关申请。
Header
| 字段 | 描述 |
|---|---|
Accept | application/json |
Content-Type | application/json |
Path Variable
| 字段 | 类型 | 描述 |
|---|---|---|
partner_code | String | 必填，商户编码，由4-6位大写字母或数字构成 |
client_report_id | String | 必填，商户申请报关单号，要求同一商户唯一(建议长度8-25位) |
JSON字段
| 字段 | 类型 | 描述 |
|---|---|---|
order_id | String | 必填，商户支付订单号(建议长度8-25位)，要求同一商户唯一 |
custom | String | 必填，海关编号 * 渠道海关编号 |
mch_custom_id | String | 必填，商户在海关备案的编号 |
mch_custom_name | String | 必填，商户海关备案名称 |
consumer_encrypt_id | String | 选填，系统加密keyid,查看 获取加密密钥 |
consumer_encrypt_info | JSONObject | 选填，消费者用户信息加密信息 |
sub_order | JSON[] | 子订单(拆单) |
consumer_encrypt_info
| 字段 | 类型 | 描述 |
|---|---|---|
consumer_name | String | 消费者姓名 |
consumer_id_no | String | 消费者身份证号 |
SUB_JSON
| 字段 | 类型 | 描述 |
|---|---|---|
sub_order_no | String | 商户子订单号(建议长度8-25位) |
fee_type | String | 币种代码 |
order_fee | Double | 子订单金额 |
transport_fee | Double | 子订单物流金额 |
product_fee | Double | 子订单商品金额 |
Query Params
| 字段 | 类型 | 描述 |
|---|---|---|
time | Long | 必填，UTC毫秒时间戳 |
nonce_str | String | 必填，随机字符串 |
sign | String | 必填，签名 |
Success 200
| 字段 | 类型 | 描述 |
|---|---|---|
report_id | String | GlobePay海关单号 |
client_report_id | String | 商户申请报关单号 |
report_status | String | 报关单状态: PROCCESSING,SUBMITED,FAILED,SUCCESS |
channel | String | 支付渠道 |
custom | String | 海关编号 |
mch_custom_no | String | 商户在海关备案的编号 |
mch_custom_name | String | 商户海关备案名称 |
order_id | String | GlobePay订单号 |
transaction_id | String | 支付渠道订单号 |
order_currency | String | 币种 |
order_amount | Double | 订单金额 |
report_time | String | 报关时间 |
creation_date | String | 报关单创建时间 |
last_update_date | String | 更新时间 |
error_code | String | 错误代码 |
error_msg | String | 错误返回的信息描述 |
错误码
| 名称 | 描述 |
|---|---|
ORDER_MISMATCH | 订单号与商户不匹配 |
SYSTEMERROR | 系统内部异常 |
INVALID_SHORT_ID | 商户编码不合法或没有对应商户 |
SIGN_TIMEOUT | 签名超时，time字段与服务器时间相差超过5分钟 |
INVALID_SIGN | 签名错误 |
PARAM_INVALID | 参数不符合要求，具体细节可参考return_msg字段 |
NOT_PERMITTED | 未开通网关支付权限 |
INVALID_CHANNEL | 不合法的支付渠道名称，请检查大小写 |
ERROR
| 名称 | 描述 |
|---|---|
return_code | Error Code |
return_msg | Error Description |