Oceanpayment Developer

概述

Oceanpayment支付接口使用了SHA256算法进行签名和验签，这是为了确保支付请求和响应数据传输的完整性、真实性，防止数据在传输过程中被篡改。这意味着需要使用SHA256算法生成请求参数的哈希摘要，接收方则用返回对应的签名验证哈希值是否一致。

注意

每个集成方式的签名生成和验签的结构是不同的。
密钥管理：secureCode（用于参加生成和验证签名的字段）必须妥善保管，绝不能泄露或存放在客户端等不安全环境，请确保从Oceanpayment官方渠道获取。

签名生成步骤（商户端）

当商户向Oceanpayment网关发送支付请求时，需要按以下步骤生成签名signValue：

参数准备：获取所有需要加密的非空请求参数；
根据不同集成方式 -【签名生成】拼接待签名字符串；
计算signValue的SHA256哈希值，传给Oceanpayment支付网关。

签名验证步骤（商户端）

当商户接收到Oceanpayment的支付结果通知或主动查询获取响应时，需要验证这些数据的真实性以确保它们确实来自Oceanpayment，且未被篡改。

接收Oceanpayment返回过来的所有参数或解析；
将返回得到的哈希值signValue与你自己在计算出的哈希值进行比对；
如果两者完全一致，则验签成功，证明数据完整且来自Oceanpayment；
如果不一致，则说明数据可能在传输过程中被篡改或来源不可信，应视为无效请求。

签名验证在以下三个环节中会出现：

签名验证(实时返回)：

通常是后端用来接收pay_url或MOTO_url的过程进行验签，不是最终支付结果（需要重定向打开支付或3D校验URL页面）；
也可以是直接返回支付结果，后端接收XML支付结果进行验签。

签名验证(同步返回backUrl)：

接收同步返回数据需要依赖交易的传参backUrl，请使用表单方式接收支付结果进行验签；
此签名结构在所有集成方案中是固定的。

异步通知(异步返回nocticeUrl)：

异步通知的验签请查看Webhook通知功能。

签名格式

集成方式	签名生成	签名验证(实时返回)	签名验证(同步返回`backUrl`)
托管结账- 商户控制重定向	`account`+`terminal`+`backUrl`+`order_number` +`order_currency`+`order_amount`+`billing_firstName` +`billing_lastName`+`billing_email`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`payment_id`+`pay_url` +`pay_results`+`pay_details`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`
托管结账- Oceanpayment自动重定向	`account`+`terminal`+`backUrl`+`order_number` +`order_currency`+`order_amount`+`billing_firstName` +`billing_lastName`+`billing_email`+`secureCode`	/	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`
嵌入式	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`billing_firstName`+`billing_lastName` +`billing_email`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`
服务器对服务器	请联系Oceanpayment技术支持 techservice@oceanpayment.com.cn	请联系Oceanpayment技术支持	请联系Oceanpayment技术支持
付款链接	`account`+`terminal`+`backUrl`+`order_number` +`order_currency`+`order_amount`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`payment_id`+`MOTO_url` +`MOTO_results`+`MOTO_details`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`
面对面付款	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`billing_firstName`+`billing_lastName` +`billing_email`+`secureCode`	`account`+`terminal`+`order_number`+`order_currency` +`order_amount`+`order_notes`+`card_number`+`payment_id` +`payment_authType`+`payment_status`+`payment_details` +`payment_risk`+`secureCode`	/

特殊字符处理

为了验证数据的一致性，所有参加签名的字段必须满足以下所有要求，否则会导致双方生成的签名不一致。

过滤字符首尾空格，并且转义双引号，小于号，大于号，单引号；
必须严格按照Oceanpayment字段排序生成签名。

//PHP
function OceanHtmlSpecialChars($parameter){
  //首尾去空格
  $parameter = trim($parameter); 
  //符号替换为空
  $parameter = str_replace(array("<",">","'","\""),array(" "," "," "," "),$parameter); 
  return $parameter;
}

哈希签名示例

签名生成
签名验证

//PHP
$signValue = hash("sha256",$account.$terminal.$backUrl.$order_number.$order_currency.$order_amount.$billing_firstName.$billing_lastName.$billing_email.$secureCode);  

//PHP
$back_signValue = $_REQUEST['signValue'];
$local_signValue = hash("sha256",$account.$terminal.$order_number.$order_currency.$order_amount.$order_notes.$card_number.$payment_id.$payment_authType.$payment_status.$payment_details.$payment_risk.$secureCode);
if (strtolower($local_signValue) == strtolower($back_signValue)){
  //处理支付结果
}else{
  //签名验证失败
}

概述​

签名生成步骤（商户端）​

签名验证步骤（商户端）​

签名格式​

特殊字符处理​

哈希签名示例​

概述

签名生成步骤（商户端）

签名验证步骤（商户端）

签名格式

特殊字符处理

哈希签名示例