招商银行API开发指南:关键函数详解

5星 · 超过95%的资源 需积分: 49 83 下载量 158 浏览量 更新于2024-10-25 1 收藏 96KB DOC 举报
招商银行的API函数开发文档提供了针对线上业务开发的实用工具,这些API主要涵盖了定单处理、信息验证以及错误信息获取等关键功能。以下是五个核心函数的详细介绍: 1. **定单撤消函数** - `shortexCancelOrder(string pszCoNo, string pszBillNo, string pszRefNo)` 这个函数用于商户撤销指定的订单。参数`pszCoNo`是商户号,`pszBillNo`是待撤销的订单号,`pszRefNo`是银行流水号。银行流水号可以通过查询未结账订单接口或支付成功通知中的参数获取。函数返回0表示操作成功,非0值则表示失败,调用`exGetLastErr`可获取具体错误信息。 2. **检验通知真实性函数** - `shortexCheckInfoFromBank(string pszPublickeyFilePath, string pszMsg)` 该函数用于验证银行发送的通知消息的数字签名。商户需要提供`pszPublickeyFilePath`,即从招商银行商户系统下载的公钥文件路径,以及银行通知的详细信息字符串`pszMsg`。成功返回0,非0值则表示验证失败,可通过`exGetLastErr`获取错误详情。 3. **数字签名验证函数** - `shortexCheckSignatureFromBank(string pszPublickeyFilePath, string pszData, string pszSignature)` 这个函数用于对数据进行签名验证,参数包括公钥文件路径、待验证的数据和银行提供的签名。验证通过后返回0,否则返回非0值和错误信息。 4. **生成验证码函数** - `objectexGenerateVerifyCode(string bKey, string bDate, string bBranchID, string bCono, string bBillno, string bAmount, string bMerchantPara, string bMerchantUrl)` 这个函数用于商户生成用于身份验证的验证码,输入参数包括密钥、日期、机构代码、订单号、金额、商户自定义参数和商户URL。验证码有助于保护交易安全。 5. **获取错误信息函数** - `stringexGetLastErr(short isNo)` 当前调用的开发包遇到错误时,可以使用此函数获取最后一次调用的错误信息,通过输入`isNo`标识符来定位具体问题。 这些API函数设计紧凑且高效,商户在与招商银行进行在线交易时能够方便地管理订单状态、确保通信安全并处理可能出现的错误。调用前后的设置和认证流程对于开发者来说尤为重要,以确保整个开发过程的合规性和安全性。