1、上 海 跨境 电子 商 务进 口 服 务 平台数据接口 支付主体上海跨境电子商务公共服务有限公司2016 年 12 月上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.02 / 12目 录第 1 章 文 档 说 明 31.1 功 能 描 述 31.2 阅 读 对 象 31.3 业 务 术 语 31.4 技 术 服 务 3第 2 章 数 据 通 讯 42.1 通 讯 协 议 及 方 式 .42.2 数 据 通 讯 限 制 .4第 3 章 请 求 接 口 说 明 53.1 备 案 申 报 类 接 口 .53.1.1 简述 .53.1.2 支 付 申
2、报 信 息 接 口 .5第 4 章 代码表 .114.1 错 误 代 码 表 .11第 5 章 附录 .125.1 国 家 或 地 区 代 码 .12上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.03 / 12第 1章 文 档 说 明1.1 功能描述1.2 阅读对象快捷支 付接 口文 档是 面向 具有一 定的 网站 开发 能力 ，了 解 ASP、 PHP、 JAVA、A SP.NET 等开 发语 言中 的一种 及 SQL 数 据 库 语 言 的 网 站 开 发 、 维 护 和 管 理 人 员 。1.3 业务术语1.4 技术服务上 海 跨 境
3、电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.04 / 12第 2章 数 据 通 讯2.1 通讯协议及方式HTTP/HTTPS 协 议 ， 传 输 数 据 方 式 通 过 POST 方 式 ， 将 数 据 提 交 给 对 方 接 收 。 其中 POST 提 交 时 只 需 2 个 参 数 ：1) CoCode： 企 业 接 口 编 号 ， 上 线 前 CBT 会 分 配 具 体 值2) EData： 原 始 接 口 数 据 信 息 (需 使 用 UTF-8 编 码 格 式 进 行 URL 编 码 )或 加 密 数 据 信 息 ， 加 密 后 需 要 base
4、64 编 码 (url 传 输 信 息 时 需 使 用 UTF-8 编 码 格 式 进 行 URL 编 码 )3) SignMsg： 摘 要 加 签 过 的 接 口 数 据 信 息 （ 针 对 Edata 原 始 数 据 未 编 码 未 加 密 ， 进 行 加 签 ）2.2 数据通讯限制支 付 /平 台 系 统 接 入 CBT(上 海 跨 境 电 商 商 务 进 口 服 务 平 台 )， 需 提 供 系 统 通 过 网 络 访 问 CBT(上 海 跨 境 电 商 商 务 进 口 服 务 平 台 )时 IP地 址 ， CBT 会 对 服 务 请 求 进 行 IP 控 制 。上 海 跨 境 电 子
5、 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.05 / 12第 3章 请 求 接 口 说 明3.1 备案申报类接口3.1.1 简述此 接 口 涉 及 支 付 信 息 主 体 系 将 支 付 信 息 及 个 人 实 名 信 息 发 送 到 CBT(上 海 跨 境 电 商 商 务 进 口 服 务 平 台 )。 商 户 系 统 通 过 HTTP/HTTPS 技 术 将 信 息 POST 到 CBT(上 海 跨 境 电 商 商 务 进 口 服 务 平 台 )， 及 CBT 平 台 接 受 响 应 ， CBT 平 台 将 审 核 结 果 信 息 POST 支 付 信 息 主
6、 体 系 统 ， 支 付 信 息 主 体 系 统 接 收 响 应 过 程 。支付主体系统 上海跨境电子商务 进口服务平台1、 备 案 请 求 信 息 (request)2、接收返回信息(response)3.1.2 支 付 申 报 信 息 接 口3.1.2.1 接口信息数 据 流 向 ： 支 付 信 息 主 体 系 统 CBT接口方式 请求地址 说明HTTP/HTTPS POST具 体 地 址 以 上 线 前 提 供为准3.1.2.2 数据字段参 数 列 表 （ 注 意 参 数 名 称 区 分 大 小 写 ） ， N 为 非 空 ， Y 为 可 空 。 长 度 1 个 字 数 可 以 是 1
7、个 汉 字 、 字 母 、 数 字 或 符 号 。序号参数名称 参数含义 长度(字数)是否 可空说明描述 例子协 议 参 数上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.06 / 121. version 网 关 版 本 10 N 固 定 值 ： v2.0 注 意 为 小 写 字 母V2.0 2. sign 加 签 方 式 16 N 字符串MD5、 RSAMD5 3. commitTime 提 交 时 间 14 N 数 字 串 ， 一 共 14 位格 式 为 ： 年 4 位 月 2 位 日 2 位 时 2 位 分 2 位 秒 2 位20071
8、117020101 4. coName 企 业 名 称 60 N 字符串 企 业 备 案 时 提 供 的 完 整 名 称xxx 支 付 公 司 5. coCode 企 业 代 码 7 N 字符串CBT 平 台 分 配 的 唯 一 企 业 代 码（7 位 字 符 ）XXXX001 6. serialNumber 流 水 号 32 N 字符串 请 求 方 生 成 唯 一 流 水 号20119182839304 业 务 参 数 ： 支 付 主 体 信 息7. merchantOrderId 商 户 订 单 号 60 N 字符串 商 家 支 付 时 提 交 的 订 单 号20140402182938.
9、 payAmount 支 付 总 金 额 19 N 数 字 串 数 字 串 中 保 留 5 位 小 数 ， 611.08000 9. payCUR 付 款 币 种 3 N 字 符 串 固 定 长 度 限 定 为 人 民 币 ， 填 写 “142” 142 10. payID 支 付 交 易 号 60 N 字 符 串 订 单 支 付 完 成 ， 支 付 返 回 的 交 易 号 2014030120394812 11. payTime 支 付 交 易 时 间 14 N 数 字 串 固 定 长 度 格 式 为 ： 年 4 位 月 2 位 日 2 位 时 2 位 分 2 位 秒 1422 位 2007
10、1117020101 12. payMethod 支 付 方 式 32 N 字 符 串 订 单 支 付 时 选 择 的 第 3 方 支 付 公 司 或 银 行 信 息 参 考 附 录 支 付 方 式 代 码 EASIPAY 13. bankPayName 付 款 银 行 名 称 32 Y 字 符 串 14. bankPayCode 付 款 银 行 编 号 32 Y 字 符 串 15. bankSerialNo 付 款 银 行 交 易 号 32 Y 字 符 串 16. appType 报 送 类 型 1 N 字 符 串 企 业 报 送 类 型 。 1-新 增 2-变 更 3 -删 除 。 默 认
11、 为 1。 1 上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.07 / 1217. payCode 支 付 企 业 代 码 18 N 字 符 串 支 付 企 业 的 海 关 注 册 登 记 编 号 。 PAY111111 18. payName 支 付 企 业 名 称 100 N 字 符 串 支 付 企 业 在 海 关 注 册 登 记 的 名 称 。 xxx 支 付 公 司 19. ebpCode 电 商 平 台 代 码 18 N 字 符 串 电 商 平 台 的 海 关 注 册 登 记 编 号 ； 电 商 平 台 未 在 海 关 注 册 登
12、记 ， 由 电 商 企 业 发 送 订 单 的 ， 以 中 国 电 子 口 岸 发 布 的 电 商 平 台 标 识 编 号 为 准 。 AAA0002 20. ebpName 电 商 平 台 名 称 100 N 字 符 串 电 商 平 台 的 海 关 注 册 登 记 名 称 ； 电 商 平 台 未 在 海 关 注 册 登 记 ， 由 电 商 企 业 发 送 订 单 的 ， 以 中 国 电 子 口 岸 发 布 的 电 商 平 台 名 称 为 准 。 xxx 网 络 公 司 21. note 备 注 1000 Y 备 注 22. Spt 扩 展 字 段 200 Y 业 务 参 数 ： 个 人 实
13、名 信 息23. personName 姓 名 32 N 字 符 串 支 付 人 的 真 实 姓 名 张 三 24. identifyType 证 件 类 型 2 N 字 符 串 1-身 份 证 ,2-其 它 。 限 定 为 身 份 证 ， 填 写 “1”。 30 25. identifyCode 证 件 号 码 32 N 字 符 串 支 付 人 的 身 份 证 件 号 码 33202928282 26. mobile 手 机 号 20 Y 字 符 串 固 定 长 度 支 付 人 的 电 话 号 码 13360x39383 27. countryCode 所 属 国 家 代 码 3 Y 字 符
14、 串 固 定 长 度 国 家 代 码 ， 目 前 默 认 156:中 国 156 28. email 电 子 邮 箱 64 Y 字 符 串 29. address 地 址 64 Y 字 符 串 上 海 张 江 xxx 路 30. sex 性 别 1 Y 字 符 串 固 定 长 度 M:男 F:女 M 31. birthday 出 生 日 期 8 Y 数 字 串 固 定 长 度 格 式 为 ： 年 4 位 月 2 位 日 2 位 19850202 上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.08 / 1232. spt 扩 展 字 段 20
15、0 Y 字 符 串 33. spt01 扩 展 字 段 200 Y34. spt02 扩 展 字 段 200 Y35. spt03 扩 展 字 段 200 Y36. spt04 扩 展 字 段 200 Y37. spt05 扩 展 字 段 200 Y38. spt06 扩 展 字 段 200 Y39. spt07 扩 展 字 段 200 Y40. spt08 扩 展 字 段 200 Y41. spt09 扩 展 字 段 200 Y42. spt10 扩 展 字 段 200 Y43. spt11 扩 展 字 段 200 Y44. spt12 扩 展 字 段 200 Y45. spt13 扩 展
16、字 段 200 Y46. spt14 扩 展 字 段 200 Y47. spt15 扩 展 字 段 200 Y48. spt16 扩 展 字 段 200 Y49. spt17 扩 展 字 段 200 Y50. spt18 扩 展 字 段 200 Y51. spt19 扩 展 字 段 200 Y52. spt20 扩 展 字 段 200 Y53. spt21 扩 展 字 段 200 Y54. spt22 扩 展 字 段 200 Y55. spt23 扩 展 字 段 200 Y56. spt24 扩 展 字 段 200 Y57. spt25 扩 展 字 段 200 Y58. spt26 扩 展 字
17、 段 200 Y59. spt27 扩 展 字 段 200 Y60. spt28 扩 展 字 段 200 Y61. spt29 扩 展 字 段 200 Y62. spt30 扩 展 字 段 200 Y3.1.2.3 数据格式支 付 主 体 /平 台 将 接 口 数 据 字 段 以 JSON 格 式 组 装 （ 以 下 是 经 过 排 版 处 理 ， 便 于 阅 读 ）上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.09 / 12“version“: “v2.0“,“commitTime“: “20071117020101“, “CoName“:
18、 “xxx 支付公司“,“CoCode“: “XXXX001“,“SerialNumber“: “20119182839304“,“MerchantOrderId“: “2014040218293“,“PayAmount“: “611.08000“,“PayCUR“: “142“,“PayID“: “2014030120394812“,“PayTime“: “20071117020101“,“payMethod“: “EASIPAY“, “bankPayName“: “,“bankPayCode“: “,“bankSerialNo“: “,“AppType“: “1“, “payCode“:
19、“PAY111111“,“payName“: “xxx 支 付 公 司 “,“ebpCode“: “AAA0002“, “ebpName“: “xxx 网 络 公 司 “,“note“: “,“Spt“: “,“personName“: “张 三 “, “identifyType“: “30“,“identifyCode“: “210304198507168185“, “mobile“: “13360x39383“, “countryCode“: “156“,“email“: ““, “address“: “上 海 张 江 xxx 路 “,“sex“: “M“, “birthday“: “19
20、850202“, “spt“: “,“spt01“: “,“spt02“: “,“spt03“: “,“spt04“: “,“spt05“: “,“spt06“: “,“spt07“: “,“spt08“: “,“spt09“: “,“spt10“: “,“spt11“: “,“spt12“: “,“spt13“: “,“spt14“: “,“spt15“: “,“spt16“: “,上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.010 / 12“spt17“: “,“spt18“: “,“spt19“: “,“spt20“: “,“spt2
21、1“: “,“spt22“: “,“spt23“: “,“spt24“: “,“spt25“: “,“spt26“: “,“spt27“: “,“spt28“: “,“spt29“: “,“spt30“: “3.1.2.4 信息结果返回支 付 信 息 主 体 系 统 调 用 CBT(上 海 跨 境 电 子 商 务 进 口 服 务 平 台 )提 供 接 口 ， 如 果 返 回 结 果 如 下 表 明 信 息 发 送 成 功 ：“status“: “success“,“code“: “,“msg“: “如 果 返 回 结 果 如 下 表 明 信 息 发 送 校 验 失 败“status“: “fa
22、ilure“,“code“: “ILLEGAL_SIGN“,“msg“: “签 名 错 误 “CBT 平 台 接 收 到 信 息 ， 业 务 处 理 过 程 中 出 现 问 题 ， 蓝 色 字 体 内 容 代 表 错 误 代 码 ， 具 体 错 误 代 码 参 考 4.1 节 接 错 误 代 码 表 。上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.011 / 12第 4章 代码表4.1 错误代码表A： 支 付 申 报 信 息 接 口错误代码值（ ErrorCode）说明 验证的地方ILLEGAL_SIGN 签 名 验 证 出 错 AILLEG
23、AL_ARGUMENT 参 数 不 正 确 (包 括 不 能 为 空 值 的 参 数 传 输 空 值 、 字 段 长 度 超 过 最 大 数 、 金 额 格 式 不 正 确 、 日 期 格 式 不 正 确 等 )AOUT_PAY_ID_EXIST 支 付 交 易 号 已 经 存 在 AILLEGAL_ IDENTIFY_CODE_PARAM 非 法 身 份 证 （ 身 份 证 号 规 则 不 正 确 或 与 性 别 和 生 日 不 一 致 ）AILLEGAL_MOBILE_PARAM 非 法 手 机 号 码 AHASH_NO_PRIVILEGE 没 有 权 限 访 问 该 服 务 AILLEG
24、AL_PARTNER 企 业 标 识 不 正 确 （ 名 称 、 代 码 与 企 业 备 案 信 息 不 符）AILLEGAL_CLIENT_IP 客 户 端 IP 地 址 无 权 访 问 服 务 ASYSTEM_ERROR 系 统 错 误 A上 海 跨 境 电 子 商 务 进 口 服 务 平 台 _数 据 接 口 _支 付 主 体 V2.012 / 12第 5章 附 录5.1 国家或地区代码英 文 代 码 代码 中 文 名 称 英 文 名 称 KOR 410 韩国 KOREA,REPUBLIC OF KOREACHN 156 中国 CHINAUSA 840 美国 UNITED STATESJ
25、PN 392 日本 JAPANHKG 344 香港 HONG KONGMAC 446 澳门 MACAUFRA 250 法国 FRANCETWN 158 台湾 TAIWAN,PROVINCE OF CHINAITA 380 意大利 ITALYAUS 036 澳 大 利 亚 AUSTRALIANZL 554 新西兰 NEW ZEALANDCAN 124 加拿大 REPUBLICGBR 826 英国 UNITED KINGDOMDEU 276 德国 GermanyNLD 528 荷兰 NETHERLANDSIDN 360 印 度 尼 西 亚 INDONESIAMYS 458 马 来 西 亚 MALAYSIASGP 702 新加坡 SINGAPORE
