- 1 口袋支付 Www.KDPay.Com口袋支付平台商户支付功能接口规范版本号 修订日期2.0 2013 年 4 月 17 日3.0 2015 年 6 月 15 日3.2 2015 年 10 月 27 日功能说明：本接口主要目的是为了让商户自有系统自由接入口袋支付平台，完成网站支付接入，用户支付后，平台会即时返回结果给商户。接口商户是根据口袋支付提供的接口文档传递相关的请求参数到平台里，口袋支付平台验证参数后，会引导用户到相应的页面进行支付操作，用户成功填入支付信息后，口袋支付平台将用户的支付成功与失败状态通知商户。接口商户可以在自己的页面带入一些附加信息，口袋支付平台在回调时将该信息原样返回。本接口支持那些语言？本平台接口支持大部分 web 语言，比如 ASP，PHP ，ASPX ，JSP。接口支持的协议方式？本平台使用 http+GET/POST 方式，如需 https 协议，请与平台客服联系。- 2 口袋支付 Www.KDPay.Com接口应用类型？接口是面向所有需要支付购买的行业，软件、商城、游戏等均可以进行集成接入。接口提交编码？口袋支付接口统一编码为：GB2312，编码错误可能导致乱码订单错误或者不能正确返回结果。支付流程图- 3 口袋支付 Www.KDPay.Com网关接口规范（1 ） 网关接口提交参数：商户向平台网关提交的参数卡类网关地址：http:/Api.Duqee.Com/pay/Card.aspx网银网关地址：http:/Api.Duqee.Com/pay/Bank.aspx兼容易宝卡类网关地址：http:/api.duqee.com/gateway/yeepay/Card.aspx兼容易宝网银网关地址：http:/api.duqee.com/gateway/yeepay/Bank.aspx网银网关包括支付宝、微信、财付通等非卡类支付方式 具体通道编码详见 具体参数详见附录参数 参数说明 参与签名 类型 备注P_UserId 商户 ID 是 整型数字 必须（商户管理中心查看）P_OrderId 商户订单号 是 字符串，最长 32 位 必须，在商户系统中保持唯一P_CardId 卡类交易时的卡号 是 字符串，最长 20 位 卡类交易时必须，网银支付为空P_CardPass 卡类交易时的卡密 是 字符串，最长 20 位 卡类交易时必须，否则可为空P_FaceValue 面值 是 float，保留 2 位小数必须P_ChannelId 充值类型 是 整型数字 必须(具体参数详见 附录)- 4 口袋支付 Www.KDPay.ComP_Subject 产品名称 否 字符串，最长 20 位 可为空P_Price 产品价格 否 float，保留 2 位小数必须，可传 0P_Quantity 产品数量 否 整型数字 必须P_Description 银行 ID 否 字符串，最长 20 位 充值类型为在线银行时必填P_Notic 用户附加信息 否 字符串，最长 50 位 可为空P_Result_URL 充值状态通知地址 否 字符串，最长 100位必须P_Notify_URL 充值后网页跳转地址 否 字符串，最长 100位可为空P_PostKey 签名认证串 字符串 必须说明：1. 签名认证 P_PostKey 的生成：必须按照 “参与签名”状态为“是”的参数按其顺序用“|” 组合，最后加上用户密钥，然后进行 32 位的 md5 编码，比如：P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass |P_FaceValue| P_ChannelId|SalfStr)，SalfStr 是您的安全码，如安全码被泄漏可通过平台重置。注意：非卡类支付时 P_CardId、P_CardPass 虽然为空但也须要参与 P_PostKey 的生成 2. P_Result_URL 必须填写，而且是 http:/开头的绝对网络地址，否则充值成功后，您将获取不到充值结果，提交信息结果 错误代码详见附录3. 接口提交例：http:/api.duqee.com/pay/Card.aspx?P_UserId=1000001&P_OrderId=90898089890we8r098erewr&P_CardId=S0989899809342343443&P_CardPass=908932849&P_FaceValue=10.00&P_ChannelId=3&P_Subject=MyPay&P_Price=10.00&P_Quantity=1&P_Description=10001&P_Notic=sometext&P_PostKey=SDFS098KLJLKSJDFSKLJLKKLSF&P_Result_url=http:/您的域名/result_url.asp&P_Notify_URL= http:/ 您的域名/notify_Url.asp- 5 口袋支付 Www.KDPay.Com示例中：www.xxx.com 是平台地址， http:/您的域名/result_url.asp 是您用于接收充值报告的回调地址，当用户通过接口充值成功后，平台后台自动调用这个地址； http:/您的域名/notify_Url.asp 是用户充值成功后的转向地址。（2） 充值状态回调/商户取货转向 参数说明充值状态回调：用户通过本平台网关支付后，本平台接收到充值报告状态时，立即向您在提交网关参数中的 P_Result_URL（充值状态回调地址），传递充值报告，您根据这个充值报告的状态，决定给是否给用户增加网站服务（常用：触发加款、触发续费等）；提醒：写结果回调时别忘了判断该订单是否已经处理过，以免造成重复处理叠加服务商户取货转向：在提交到 API 接口的时候，如果正确传递了 P_Notify_URL 参数，那么在商户充值成功后时，就自动转向到P_Notify_URL 所指的地址，同时跟上以下参数表的所有参数。以下是充值报告状态参数列表：参数 参数说明 参与签名 类型 备注P_UserId 商户 ID 是 整型数字 必须P_OrderId 商户订单号 是 字符串，最长 32 位 必须，在商户系统中保持唯一P_CardId 卡类充值时的卡号 是 字符串，最长 20 位 卡类充值时必须，否则可为空P_CardPass 卡类充值时的卡密 是 字符串，最长 20 位 卡类充值时必须，否则可为空P_FaceValue 面值 是 float，保留 2 位小数必须P_ChannelId 充值类型 是 整型数字 必须(具体参数详见附录)P_PayMoney 实际充值金额 否 float，保留 2 位小数必须P_Subject 产品名称 否 字符串，最长 20 位 可为空- 6 口袋支付 Www.KDPay.ComP_Price 产品价格 否 float，保留 2 位小数必须，可传 0P_Quantity 产品数量 否 整型数字 必须P_Description 银行 ID（点击查看） 否 字符串，最长 20 位 充值类型为在线银行时必填P_Notic 用户附加信息 否 字符串，最长 50 位 可为空P_ErrCode 错误代码 否 整型数字 必须(错误代码详见附录)P_ErrMsg 错误描述 否 字符串 可为空P_PostKey 签名认证串 字符串 必须说明： ErrCode=0 为充值成功 签名认证 postKey 的生成：必须按照 “参与签名”状态为“ 是”的参数按其顺序用“|” 组合，最后加上用户密钥，然后进行 32 位的 md5 编码，比如：P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass| P_FaceValue| P_ChannelId|SalfStr)，SalfStr 是您的安全码，如安全码被泄漏可通过平台重置 通过后台接收返回时，接收到数据后，不论充值成功与否，请在页面上显示 errCode=0，不要其它任何字符及 html 代码订单查询接口商户可通过登录口袋支付来查看订单信息，也可以通过此订单查询接口来获取信息 商户向查询接口提交请求 订单接口验证商户提交请求数据的完整性及正确性，对 md5 组合验证（详见 MD5 组合验证）、商户 ID 做验证 请求通过接口验证，返回商户订单信息。- 7 口袋支付 Www.KDPay.Com以下是提交查询请求的参数列表：参数 参数说明 参与签名 类型 备注P_UserId 商户 ID 是 整型数字 必须P_OrderId 商户订单号 是 字符串，最长 32 位 必须P_ChannelId 充值类型 是 整型数字 必须(具体参数详见附录)P_CardId 卡类充值时的卡号 是 字符串，最长 20 位 必须P_FaceValue 面值 是 float，保留 2 位小数必须P_PostKey 签名认证串 字符串 必须，32 位小写查询接口提交地址为：http:/Api.Duqee.Com/pay/query.aspx说明：签名认证 P_PostKey 的生成：必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合，最后加上用户密钥，然后进行 32位的 md5 编码。比如：P_PostKey=md5( P_UserId=&P_OrderId=&P_ChannelId=&P_CardId=&P_FaceValue=&P_PostKey=SalfStr)其中 SalfStr 是您的安全码，如安全码被泄漏可联系客服重置。完整的提交示例为：http:/api.duqee.com/pay/queryaspx?P_UserId=1000001&P_OrderId=201204171453101077970&P_ChannelId=14&P_CardId=52342342341231111&P_FaceValue=10&P_PostKey=b83f5f2d5b193a262232d9ca5817d819获取订单查询结果- 8 口袋支付 Www.KDPay.Com参数 参数说明 参与签名 类型 备注P_UserId 商户 ID 是 整型数字 必须P_OrderId 商户订单号 是 字符串，最长 32 位 必须P_ChannelId 充值类型 是 整型数字 必须(具体参数详见附录)P_CardId 卡号 是 字符串，最长 20 位 必须P_payMoney 实际成功金额 是 float，保留 2 位小数必须P_flag 订单提交状态 是 float，保留 2 位小数说明见下判断订单状态说明P_status 订单处理状态 是 float，保留 2 位小数说明见下判断订单状态说明P_PostKey 签名认证串 字符串 必须，32 位小写判断订单状态说明：P_flag=0 且 P_status=0 时 订单状态为：处理中P_flag=1 且 P_status=0 时 订单状态为：失败P_flag=1 且 P_status=1 时 订单状态为：成功- 9 口袋支付 Www.KDPay.Com说明：P_PostKey=md5(P_UserId=&P_OrderId=&P_ChannelId=&P_CardId=&P_payMoney=&P_flag=&P_status =&P_PostKey=SalfStr)查询结果完整的示例：P_UserId=2079&P_OrderId=201204171453101077970&P_ChannelId=14&P_CardId=52342342341231111&P_payMoney=0&P_flag=1&P_status=0&P_ErrMsg=充值卡无效&P_Pos