与银商电子账单系统接口说明（定稿）.doc

与银商电子账单系统接口说明 银商商务有限公司 二零一一年九月 接口技术规范 文档修订历史 版本号 日期 说明 作者/审阅 V1.0 2011-9-21 拟稿 xychen V1.1 2011-11-30 增加查询接口 xychen 目 录 1 接口说明 4 1.1 账单提交 4 1.1.1 提交请求 4 1.1.2 账单应答 5 1.1.3 测试参数及说明 6 1.2 账单查询 7 1.2.1 查询请求 7 1.2.2 查询应答 8 1.3 账单成功通知（采用HTTPCLIENT方式通知账单支付的情况） 10 接口说明 账单提交 提交请求 提交的URL （必填） 中文域名 英文域名 数据类型 数据类型 交易类型代码 txn_code 交易类型代码 A1000(5位) （必填） 请求机构代码 req_org_id 渠道请求机构代码（15位） （必填） 请求流水号 req_seq_id 请求机构流水（最大10位） （必填） 提交机构代码 put_org_id 账单提交方（15位） （必填） 出账机构代码 bill_org_id EBPP系统中出账机构的编码 （15位） （必填） 账单业务代码 buss_id 出账机构的业务编码，不同业务不同代码表示（10位） （必填） 账单条码号 bill_barcode 具备条码号的录入条码数据（最大40位） 由账单业务模板决定 用户姓名 user_nm 账单的属主信息（最大40位） 由账单业务模板决定 用户地址 user_add 账单的属主信息（最大200位） 由账单业务模板决定 外部用户号 ext_user_id 外部系统注册名（最大50位） 由账单业务模板决定 合同号 contract_no 账单的合同编号（最大50位） 由账单业务模板决定 账单总资费 tot_fee_at 账单费用（10位） （必填） 账单应付金额 owe_fee_at 账单应付金额（10位） （必填） 账单优惠金额 discount_at 账单优惠金额（10位） （必填） 应收滞纳金 delay_at （10位） 由账单业务模板决定 应收罚金 punish_at （10位） 由账单业务模板决定 帐期 pay_month_dt （6位） 由账单业务模板决定 抄次 record_times （2位） 由账单业务模板决定 开帐日期 account_dt （8位） 由账单业务模板决定 最后缴款日期 last_pay_dt （8位） 由账单业务模板决定 约定扣款日期 assu_pay_dt （8位） 由账单业务模板决定 通知标志 confirm_in 0-不通知 1- 短信通知 2-MAIL通知 3-短信MAIL均通知 （1位） 由账单业务模板决定 手机号 mobile_phone （最大15位） 由账单业务模板决定 MAIL mail_info （最大40位） 由账单业务模板决定 账单备注 bill_tx 扩展（最大2000位） 由账单业务模板决定 杂类项 misc_tx 扩展（最大1024位） 由账单业务模板决定 扩展键1 sub_key1_cd 扩展（最大40位） 由账单业务模板决定 扩展键2 sub_key2_cd 扩展（最大40位） 由账单业务模板决定 扩展键3 sub_key3_cd 扩展（最大40位） 由账单业务模板决定 扩展键4 sub_key4_cd 扩展（最大40位） 由账单业务模板决定 扩展键5 sub_key5_cd 扩展（最大40位） 由账单业务模板决定 扩展键6 sub_key6_cd 扩展（最大40位） 由账单业务模板决定 提交时间 submit_time 账单提交时间（14位） yyyyMMddHHmmss （必填） 签名域 md5 加密结果（32位） （必填） 账单应答 系统在处理相关的检查之后，数据入库并返回入库结果表单。返回数据包括： URL （必填） 中文域名 英文域名 数据类型 数据类型 交易类型应答码 txn_code A1001（5位） （必填） 请求机构代码 req_org_id 渠道请求机构代码（15位） （必填） 请求流水号 req_seq_id 请求机构流水（最大10位） （必填）原样返回 提交机构代码 put_org_id EBPP系统中提交账单数据的机构编码（15位） （必填） 出账机构代码 bill_org_id EBPP系统中出账机构的编码（15位） （必填） 账单业务代码 buss_id 出账机构的业务编码，不同业务不同代码表示（10位） （必填） 账单总资费 tot_fee_at 账单费用（10位） （必填） 账单应付