概述

海关上送通知是Oceanpayment获取海关上送结果后（通过/不通过），通过异步通知回传给商户上送的结果。

在此之前

信息

请查看Oceanpayment完整的重推机制和规范。

参数名	类型	描述	示例
account	string	Oceanpayment账户号
terminal	string	Oceanpayment终端号
signValue	string	安全签名，用于验证交易的安全性，使用SHA256加密
payment_dateTime	string	订单支付时间
payment_debitTime	string	完成时间
push_dateTime	string	推送时间
order_number	string	网站订单号
order_currency	string	订单号的交易币种 采用国际标准ISO 4217代码
order_amount	string	订单号的交易金额 最大支持小数点后2位数，如：1.00
order_notes	string	订单备注信息，返回时则原样返回
card_type	string	卡种
card_country	string	卡属国家
payment_id	string	支付ID，Oceanpayment的支付唯一单号
refund_number	string	商户网站系统内部的退款流水号
refund_reference	string	商户网站系统内部的退款参考号
notice_type	string	业务推送类型 identityCheck: 身份校验 customsUpload: 支付凭证上送结果
push_status	string	业务结果状态 0: 失败 1: 成功
push_details	string	具体详细信息
push_id	string	业务状态交易ID，Oceanpayment的唯一业务状态编号 •当业务类型是退款时，此字段的值等于退款ID
verify_department	string	验核机构
verify_id	string	验核机构交易流水号
sub_order_number	string	商户子订单号，拆单时返回

通知类型

在海关上送通知参数中：

• notice_type：是用来区分海关上送的推送类型；
• push_status：海关上送推送结果；
• push_details：海关上送具体详细信息。

返回XML示例

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <account>995149</account>
  <terminal>99514901</terminal>
  <signValue>0DB0C564E97C1459250333E67F1FCD8B0789BB1D2A3A0D87E878B1CC8A7485F6</signValue>
  <payment_dateTime>2024-11-24 19:43:27</payment_dateTime>
  <payment_debitTime>2024-11-24 19:43:27</payment_debitTime>
  <push_dateTime>2024-12-01 17:55:43</push_dateTime>
  <order_number>110529-EVEVSY11438</order_number>
  <order_currency>CNY</order_currency>
  <order_amount>0.01</order_amount>
  <order_notes></order_notes>
  <card_type></card_type>
  <card_country></card_country>
  <payment_id>211124194326789278592</payment_id>
  <refund_number></refund_number>
  <refund_reference></refund_reference>
  <notice_type>customsUpload</notice_type>
  <push_id></push_id>
  <push_status>1</push_status>
  <push_details>1:Success</push_details>
  <verify_department>OTHERS</payment_cpdTime>
  <verify_id>42000028632025091986588035</verify_id>
  <sub_order_number>110529-EVEVSY11438-1</payment_cpdTime>
</response>

接收示例

通过交易请求的参数noticeUrl进行接收：

PHP

//获取推送输入流XML
$xml_str = file_get_contents("php://input");
//判断返回的输入流是否为xml  
if(xml_parser($xml_str)){
	$xml = simplexml_load_string($xml_str);		
	//把推送参数赋值到$_REQUEST
	$_REQUEST['account'] = (string)$xml->account;
	$_REQUEST['terminal'] = (string)$xml->terminal;
	$_REQUEST['signValue'] = (string)$xml->signValue;
	$_REQUEST['payment_dateTime'] = (string)$xml->payment_dateTime;
	$_REQUEST['payment_debitTime'] = (string)$xml->payment_debitTime;
	$_REQUEST['push_dateTime'] = (string)$xml->push_dateTime;
	$_REQUEST['order_number'] = (string)$xml->order_number;		
	$_REQUEST['order_currency'] = (string)$xml->order_currency;	
	$_REQUEST['order_amount']= (string)$xml->order_amount;
	$_REQUEST['order_notes'] = (string)$xml->order_notes;
	$_REQUEST['card_type'] = (string)$xml->card_type;
	$_REQUEST['card_country'] = (string)$xml->card_country;		
	$_REQUEST['payment_id'] = (string)$xml->payment_id;
	$_REQUEST['refund_number']= (string)$xml->refund_number;
	$_REQUEST['refund_reference'] = (string)$xml->refund_reference;	
	$_REQUEST['notice_type'] = (string)$xml->notice_type;		
	$_REQUEST['push_id'] = (string)$xml->push_id;
	$_REQUEST['push_status'] = (string)$xml->push_status;
	$_REQUEST['push_details'] = (string)$xml->push_details;
	$_REQUEST['verify_department'] = (string)$xml->verify_department;
	$_REQUEST['verify_id'] = (string)$xml->verify_id;
	$_REQUEST['sub_order_number'] = (string)$xml->sub_order_number;
}

//判断是否为xml
function xml_parser($str){
	$xml_parser = xml_parser_create();
	if(!xml_parse($xml_parser,$str,true)){
		xml_parser_free($xml_parser);
		return false;
	}else {
		return true;
	}
}

安全验证签名

类型	签名结构
异常订单	account+terminal+order_number+payment_id+refund_number+push_id+push_status+push_details+secureCode

签名验证示例

PHP

$_REQUEST['signValue'] = (string)$xml->signValue;

//获取本地的secureCode值  
$secureCode = {secureCode};  
$local_signValue = hash("sha256",$_REQUEST['account'].$_REQUEST['terminal'].$_REQUEST['order_number'].$_REQUEST['payment_id'].$_REQUEST['refund_number'].$_REQUEST['push_id'].$_REQUEST['push_status'].$_REQUEST['push_details'].$secureCode);
//加密串校验  
if (strtolower($local_signValue) == strtolower($_REQUEST['signValue'])) {
    //异常订单类型
    if ($_REQUEST['notice_type'] == 'Refund') {				 
       //全额退款  		
    }elseif{
       //其他类型等
    }			 
}else{			 
  //校验失败	  				 
}		
echo "receive-ok";
exit;