记录一个使用第三方USDT支付通道的PHP项目的开发过程及解决方案

1. 项目的需求背景
   接到一个项目，需要收付USDT，顾客要求用币安链的，即BSC链，需要实现：

充值监控：当用户通过区块链钱包将 USDT 转账到指定地址时，系统能够监控并确认充值到账。
提现功能：当用户发起提现请求时，系统能够根据用户指定的地址，自动完成 USDT 的转账操作。
交易安全性：确保每笔交易都具有合法性，防止双花攻击或伪造交易。

要是都自己做，费钱费力还容易出问题，还是用第三方USDT支付通道吧。想起以前同事用过UBAO.IO，用起来还不错，还是使用UBAO吧。注册地址：https://m.ubao.io/#/login?c=8YmVrlk 。注册后保存商户号和API_SECRET备用。

2. 开发过程
   代码，用PHP。商业逻辑，倒也没什么说的。主要记录一下支付这一块。
   想法是，生成一批钱包地址，保存在本地数据库中，供会员轮流使用，时限24小时。比如，甲会员需要付款，那就调用一个地址A，标记调用时间，24小时内，只要地址A进来的USDT，都认为是甲会员所付（这个时间已经很宽松了，大多数人付款，时间也就几分钟，不会超过半小时）。如果再来乙会员，那就调用地址B，依次类推。24小时后，这些地址释放，供会员轮流调用，这样比较节约地址。毕竟付款的动作，不是每个会员每天都做。

生成地址的代码：

//調用API生成一個錢包地址 
$url = "https://api.ubao.id/mch/address/create";

$merchantId = "12345"; //商戶號 
$api_key = "123456789"; //商戶密鑰 

$timestamp = time();
//結果：1725607713
$nonce = rand(100000,999999);
//結果：212343

$body_data = array('chainType'=>170,'type'=>0,'callUrl'=>'http://www.xxx.com/callback.html'); 
//把body數組轉為JSON字符串 
$str = json_encode($body_data);
//結果：{"chainType":170,"type":0,"callUrl":"http:\/\/www.xxx.com\/callback.html"}

//再用base64編碼，得到最終的body字符串 
$body = base64_encode($str);
//結果：eyJjaGFpblR5cGUiOjE2MCwidHlwZSI6MCwiY2FsbFVybCI6Imh0dHA6XC9cL3d3dy54eHguY29tXC94eHguaHRtbCJ9

//簽名 
$sign = md5($body . $api_key . $nonce . $timestamp);
//結果：5eab870f6a4fea6caabc6e0be4308bf0

//提交給網關的數據  
$data = array('merchantId'=>$merchantId,'timestamp'=>$timestamp,'nonce'=>$nonce,'sign'=>$sign,'body'=>$body);

//用POST方式提交給網關 
$res = curlPost($url,$data);
//結果：{"code":200,"message":"SUCCESS","address":"0xD3b0d838cCCEAe7ebF1781D11D1bB741DB7Fe1A8","chainType":170}
//这个address ，就是钱包地址，保存到本地数据库。如果需要更多地址，再调用就是。
//......



function curlPost($url, $post_data = array(),$timeout = 5, $header = array("content-type: application/x-www-form-urlencoded"), $data_type = "") {
	$header = empty($header) ? '' : $header;
	if($data_type == 'json'){
		$post_string = json_encode($post_data);
	}elseif($data_type == 'array') {
		$post_string = $post_data;
	}elseif(is_array($post_data)){
		$post_string = http_build_query($post_data, '', '&');
	}
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
	curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_string);     
	curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
	curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 
	curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
	$result = curl_exec($ch);
	curl_close($ch);
	
	return $result;
}

3.如果有会员付款，UBAO会通知上面留下的回调地址 http://www.xxx.com/callback.html 。然后在这个程序里处理一下。

$api_key = "123456789"; //商戶密鑰 

$body = $_POST['body'];
$sign = $_POST['sign'];
$nonce = $_POST['nonce'];
$timestamp = $_POST['timestamp'];

$msg = "";

try {
	$sign2 = md5($body . $api_key . $nonce . $timestamp);
	
	if($sign2 != $sign){
		$msg = "sign error";
		throw new Exception();
	}
	
	$json = json_decode(base64_decode($body),true);
	
	$decimals = $json['decimals'];
	$amount = number_format($json['amount']/pow(10,$decimals),3,'.','') + 0;
	
	if($json['callbackType'] == 'recharge'){
	    //充幣的業務邏輯處理 
                                if($json['chainType'] == 170 && $json['coinID'] == 1002){ //币安链的USDT
                                    $address = $json['address'];//收款的地址
                                    //找到本地数据库记录的锁定此地址的会员，将他的付款状态改为付款成功。
                                    。。。。
                                }
	}
	
	if($json['callbackType'] == 'transfer'){
	    //提幣或轉賬的業務邏輯處理 
		if($json['result'] == 1){
			//轉賬成功 
		}
		else{
			//轉賬失敗 
			$msg = $json['message'];
		}
	}
	
	if($json['callbackType'] == 'balance'){
	    //得到地址余額的業務邏輯處理 
	}
	
	$msg = "SUCCESS";
	
}
catch (Exception $e) {
	//
}

echo $msg;

4. 测试与后记
   测试起来，挺顺利。顾客也挺满意。收尾款，收工。至于说以后可用地址不足，让他花钱升级就是了。也不麻烦。