chinapay交易接口开发说明

### ChinaPay交易接口开发概述与关键技术点 #### 一、交易接口功能概览 ChinaPay提供的交易接口主要包括四大核心功能： 1. **支付交易功能**：实现商户与ChinaPay之间的交易处理，支持订单的创建与确认。 2. **支付对账功能**：提供对账服务，确保交易记录的一致性和准确性。 3. **支付查询功能**：允许商户查询交易状态，包括成功、失败或待处理的状态。 4. **支付退款功能**：支持商户发起退款操作，处理交易的反向流程。 #### 二、交易接口的关键要素 ##### 请求要素： - **URL地址**：指定提交交易数据的目标位置。 - **商户号**：ChinaPay分配给每个商户的唯一标识符。 - **交易订单号**：商户生成的唯一订单标识，用于区分不同的交易。 - **订单交易金额**：交易的具体金额，单位为分。 - **订单交易币种**：交易的货币种类，如人民币。 - **订单交易日期**：交易发生的具体日期。 - **交易类型**：定义交易的性质，如购买或退款。 - **支付接入版本号**：指明使用的支付接口版本。 - **后台交易接收URL**：用于接收交易结果的后台地址。 - **页面交易接收URL**：用于用户界面返回的前端地址。 - **支付网关号**：可选参数，用于指定特定的支付通道。 - **商户私有域**：商户自定义信息，不参与交易逻辑。 - **数字签名**：确保数据完整性和安全性的加密值。 ##### 应答要素： - 成功响应包含：商户号、交易订单号、交易日期、金额、币种、类型、状态、数字签名、支付网关号及商户私有域。 - 失败响应则提供具体的失败原因信息。 #### 三、交易数据的数字签名机制 数字签名是交易接口中的重要安全措施，用于验证数据的完整性和防止篡改。ChinaPay要求所有交易数据在提交前必须经过数字签名。这一过程使用特定的算法和密钥，确保数据在传输过程中不会被非法修改。 不同开发环境下的数字签名实现方式如下： - **Java环境**：使用`NetPayClientforJava`类的`sign`方法。 - **Win32环境**：调用`NetPayClientforWin32`的`signData`函数。 - **C环境**：利用`NetPayClientforC`的`signData`函数。 #### 四、交易提交数据内容示例 交易数据的提交是通过构建HTML表单并设置相应字段实现的。例如： ```html <form action="https://payment.ChinaPay.com/pay/TransGet" method="post"> <input type="hidden" name="MerId" value="808080290000001"/> <input type="hidden" name="OrdId" value="0000000000000006"/> <input type="hidden" name="TransAmt" value="000000001234"/> <input type="hidden" name="CuryId" value="156"/> <input type="hidden" name="TransDate" value="20070801"/> <input type="hidden" name="TransType" value="0001"/> <input type="hidden" name="Version" value="20070129"/> <input type="hidden" name="BgRetUrl" value="http://www.chinaypay.com/pay/Bgreturn.jsp"/> <input type="hidden" name="PageRetUrl" value="www.chinaypay.com/pay/Pgreturn.jsp"/> <input type="hidden" name="GateId" value="0001"/> <input type="hidden" name="Priv1" value="Memo"/> <input type="hidden" name="ChkValue" value="X…X"/> </form> ``` #### 五、重要注意事项 - **数字签名**：确保交易数据的安全性，防止中间人攻击。 - **后台与页面接收URL**：区分交易应答的处理逻辑，后台用于数据处理，页面用于用户体验。 - **支付网关号**：可选配置，用于快速指定支付通道。 - **商户私有域**：用于传递商户自定义信息，不参与交易核心流程。 ChinaPay交易接口开发涉及多个关键环节，包括交易请求与响应的要素、数据的数字签名、以及具体的交易数据提交格式。掌握这些要点对于成功集成ChinaPay支付系统至关重要。