global pay
1.1.2
국제 지불을 지원하는 PHP SDK는 현재 Alipay International 버전에서만 지원됩니다 . Alipay의 국경 간 온라인 결제 서비스는 현재 앱, WAP, 웹 및 세관 선언의 4 가지 유형 만 지원하기 때문에이 SDK는 세 가지 국경 간 지불 (앱, WAP 및 웹)을 제공합니다. 자세한 내용은 공식 Alipay International 지불 문서를 참조하십시오.
이 창고를 만들려는 원래 의도는 현재 내 유닛이 현재 국경 간 지불이 필요하다는 것입니다. 국내 지불금은 항상 Yansongda/Pay Prespansion 패키지를 채택 했으며이 통화 방법에 사용됩니다. 그러나 패키지는 당분간 해외 지불을 지원하지 않기 때문에 소매를 굴려서 직접 쓸 수 있습니다. 이 확장 패키지가 팀에 내부적으로 사용되기를 원하지만 최근에는 친구가 해외 지불에 사용할 확장 패키지를 묻습니다. 이 패키지에 버그가 있으면 PR을 언급하십시오. 모든 학생들이 행복하게 사용할 수 있기를 바랍니다!
이 확장 패키지의 기능은 귀하가있는 장치의 요구에 따라 확장되기위한 것입니다. 따라서 국경 간 Alipay 지불은 당시에 만 고려되며 다른 사람들은 당분간 고려되지 않습니다.
composer require pudongping/global-pay -vvvhttps://pudongping.github.io/global-pay-doc
| 방법 | 설명하다 |
|---|---|
| 편물 | 컴퓨터 결제 |
| WAP | 모바일 웹 사이트 결제 |
| 앱 | 앱 지불 |
찾기 (배열 | 문자열 $ 주문)
설명 : 주문 인터페이스를 찾으십시오
매개 변수 : $order string 유형 인 경우, 국경 간 Alipay의 out_trade_no 매개 변수에 해당하는 시스템 주문 번호를 전달하십시오. array 유형은 매개 변수에 대해서는 Alipay 해외 주문 쿼리 문서를 참조하십시오.
반환 : 쿼리가 성공적이며, IlluminateSupportCollection 인스턴스는 $collection->toArray() , $collection->all() 또는 $collection->get('field') 통해 액세스 할 수 있습니다.
환불 (배열 $ 주문)
설명 : 환불 인터페이스
매개 변수 : $order 배열 형식, 환불 매개 변수는 Alipay 해외 환불 인터페이스 문서를 참조하십시오.
반품 : 환불이 성공적이며 IlluminateSupportCollection 인스턴스는 $collection->toArray() , $collection->all() 또는 $collection->get('field') 를 통해 액세스 할 수 있습니다.
확인하다()
설명 : 서버에서 반환 한 데이터가 합법적인지 확인
반품 : 확인이 성공적이며 IlluminateSupportCollection 인스턴스는 $collection->toArray() , $collection->all() 또는 $collection->get('field') 통해 액세스 할 수 있습니다.
getexChangerate ()
설명 : 환율을 얻으십시오. 자세한 내용은 Alipay 해외 환율 쿼리 인터페이스를 참조하십시오.
반품 : 성공을 거두고 IlluminateSupportCollection 인스턴스를 반환하면 $collection->toArray() 또는 $collection->all() 또는 $collection->get('field') 통해 서버에서 반환 한 데이터에 액세스 할 수 있습니다.
참고 : 1. 통화 사이의 환율은 매일 9:00에서 11:00 사이에 한 번 변경됩니다. 2. 일일 최대 환율 획득은 100 배입니다. (이 SDK가 캐시 처리를 수행하지 않기 때문에 인터페이스의 이상을 방지하기 위해 캐시를 통해 환율을 저장하는 것을 고려해야 할 수도 있습니다).
gethbfqcost (float $ totalamount, bool $ isshowall = false, bool $ issellerpercent = false)
설명 : Huabei 할부 청구 상황을 얻습니다
매개 변수 : $totalAmount 할부 교장이며, $isShowAll 각 기간의 상환 번호를 표시 할 것인지, $isSellerPercent true 입니다. 이는 판매자가 모든 취급 수수료를 부담하고 false 사용자가 모든 취급 수수료를 부담한다는 것을 의미합니다.
반품 : 성공을 거두고 IlluminateSupportCollection 인스턴스를 반환하면 $collection->toArray() 또는 $collection->all() 또는 $collection->get('field') 통해 서버에서 반환 한 데이터에 액세스 할 수 있습니다.
매개 변수 설명으로 돌아갑니다
| 매개 변수 | 의미 |
|---|---|
| nper | 기간 수 |
| Total_amount Total_amount | 주요한 |
| Total_pharge | 총 처리 수수료 |
| 비율 | 이자율 |
| per_pharge | 각각의 취급 수수료 |
| per_amount | 각 기간에 대한 원금 금액 |
| per_total_amount | 기간 당 총 수수료 |
| 환불_list | 상환 목록 |
| REUNUND_LIST.NPER | 어떤 문제 |
| REPUND_LIST.PARGE | 현재 기간에 필요한 취급 수수료 |
| REUNNED_LIST.AMOUNT | 현재 기간 동안 지불 할 교장 금액 |
| RENFUND_LIST.CURRENT_TOTAL_AMOUNT | 현재 기간에 필요한 총 수수료 |
<?php
declare (strict_types= 1 );
namespace App Controller ;
use Pudongping GlobalPay GlobalPay ;
use Pudongping GlobalPay Log ;
class PayController
{
protected $ config = [
' partner ' => ' 2088000000000000 ' , // 合作身份者 id，以 2088 开头的 16 位纯数字
' notify_url ' => ' http://a90b-8-37-43-168.demo.io/index/notify_url ' , // 异步回调地址
' return_url ' => ' http://a90b-8-37-43-168.demo.io/index/return_url ' , // 同步回调地址
' refer_url ' => ' https://www.demo.net ' , // 二级商户网站地址
' seller_email ' => ' [email protected] ' , // 签约支付宝账号或卖家支付宝帐户
' key ' => ' xxxx ' , // 安全检验码，以数字和字母组成的 32 位字符
' sign_type ' => ' RSA ' , // 不需要修改
' input_charset ' => ' UTF-8 ' , // 商户网站使用的编码格式，建议不需要修改
' transport ' => ' http ' , // 访问模式,根据自己的服务器是否支持 ssl 访问，若支持请选择 https；若不支持请选择 http
' split_fund ' => ' 2088000000000000:0.10 ' , // 接受分账资金的支付宝账户 ID 和比例，用逗号分隔其他帐号信息。ID 是以 2088 开头的纯 16 位数字。
' private_key ' => ' /Users/pudongping/glory/key/alipay_private_key.pem ' , // 私钥路径
' public_key ' => ' /Users/pudongping/glory/key/alipay_public_key.pem ' , // 公钥路径
' log ' => [ // optional
' file ' => ' alipay.log ' , // 当前目录下
' level ' => ' debug ' , // 建议生产环境等级调整为 info，开发环境为 debug
' type ' => ' single ' , // optional, 可选 daily.
' max_file ' => 30 , // optional, 当 type 为 daily 时有效，默认 30 天
],
' http ' => [ // optional
' timeout ' => 5.0 ,
' connect_timeout ' => 5.0 ,
// 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
],
' mode ' => ' dev ' , // optional,设置此参数，将进入沙箱模式
];
/**
* document link: https://global.alipay.com/docs/ac/web_cn/about
*
* @return mixed
*/
public function web ()
{
$ order = [
' out_trade_no ' => time (),
' subject ' => '交易 alex ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => ' 0.20 ' ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '変身ベ...^1 ' ,
' total_quantity ' => 1
], 256 ),
// '_only_args' => true // 只需要返回参数模式时增加
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> web ( $ order );
return $ globalPay -> send ();
// 如果设置了 `_only_args` 为 true，则使用以下方法获取所有的参数
// var_dump($globalPay->getContent());
}
/**
* document link: https://global.alipay.com/docs/ac/wap_cn/start
*
* @return mixed
*/
public function wap ()
{
$ order = [
' out_trade_no ' => time (),
' subject ' => '交易 alex ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => ' 0.10 ' ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '変身ベ...^1 ' ,
' total_quantity ' => 1
], 256 ),
// '_only_args' => true // 只需要返回参数模式时增加
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> wap ( $ order );
return $ globalPay -> send ();
// 如果设置了 `_only_args` 为 true，则使用以下方法获取所有的参数
// var_dump($globalPay->getContent());
}
/**
* document link: https://global.alipay.com/docs/ac/app_cn/about
*/
public function app ()
{
$ order = [
' out_trade_no ' => ' alex_ ' . time (),
' subject ' => '交易 5200 ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => ' 1.01 ' ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '大海にて^1 ' ,
' total_quantity ' => 1
], 256 ),
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> app ( $ order );
$ content = $ globalPay -> getContent ();
var_dump ( $ content );
}
/**
* 单笔查询接口 document link: https://global.alipay.com/docs/ac/global/single_trade_query_cn
*/
public function find ()
{
// out_trade_no 和 trade_no 参数可以同时含有，也可以二选一
$ order = [
' out_trade_no ' => ' alex_1629950066 ' ,
// 'trade_no' => '2021082622001364941434754996',
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> find ( $ order );
var_dump ( $ globalPay -> toArray ());
}
/**
* 退款接口 document link： https://global.alipay.com/docs/ac/global/forex_refund_cn
*/
public function refund ()
{
$ order = [
' out_return_no ' => ' alex_refund_ ' . time (),
' out_trade_no ' => ' alex_1629950066 ' ,
' return_rmb_amount ' => ' 1.01 ' ,
' currency ' => ' JPY ' ,
' reason ' => '退款测试' ,
// 'is_sync' => 'N', // 如果 is_sync => N 则开启异步通知，否则不开启异步通知，不开启异步通知 notify_url 参数将会失效（不需要开启时，则不需要设置）
// 'notify_url' => 'http://api.demo.com:8016/v2/alipay/forexNotify', // $order['notify_url'] 设置了，则使用 $order['notify_url'] 的值，否则使用配置文件中的 notify_url 参数
// 'type' => 'pc', // 如果是网站支付，则需要设置 type 参数为 pc，手机浏览器或支付宝钱包支付时，不需要设置
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> refund ( $ order );
var_dump ( $ globalPay -> toArray ());
}
/**
* 同步验签
*/
public function return ()
{
$ data = GlobalPay:: alipay ( $ this -> config )-> verify ();
}
/**
* 异步验签
*
* @return mixed
*/
public function notify ()
{
$ globalPay = GlobalPay:: alipay ( $ this -> config );
try {
$ data = $ globalPay -> verify (); // 验签
// 建议必须对以下几个参数进行业务逻辑验证
$ outTradeNo = $ data -> get ( ' out_trade_no ' ); // 商户需要验证该通知数据中的 out_trade_no 是否为商户系统中创建的订单号。
$ tradeStatus = $ data -> get ( ' trade_status ' ); // 在支付宝的业务通知中，只有交易通知状态为 TRADE_FINISHED 时，支付宝才会认定为买家付款成功。
$ totalFee = $ data -> get ( ' total_fee ' ); // 该笔订单的总金额。请求时对应的参数，原样通知回来。（外币金额）
Log:: debug ( ' GlobalPay Notify ===> ' , $ data -> all ());
} catch ( Exception $ exception ) {
Log:: error ( '异步通知异常 ===> ' . $ exception -> getMessage ());
return $ globalPay -> fail ()-> send (); // 其他框架
// return $globalPay->fail(); // Laravel 框架可以直接这样
}
return $ globalPay -> success ()-> send (); // 其他框架
// return $globalPay->success(); // Laravel 框架可以直接这样
}
/**
* 获取汇率
*/
public function getExchangeRate ()
{
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> getExchangeRate ();
var_dump ( $ globalPay -> toArray ());
}
} <?php
declare (strict_types= 1 );
namespace App Controller ;
use Pudongping GlobalPay GlobalPay ;
use Pudongping GlobalPay Log ;
class HbfqPayController
{
public function web ()
{
$ order = [
' out_trade_no ' => time (),
' subject ' => '交易 alex ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => 5.45 ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '交易费用^1 ' ,
' total_quantity ' => 1
], 256 ),
' hb_fq_param ' => [
' num ' => 3 , // 花呗分期分期数，只支持 3、6、12 期
// 只有 is_has_household 为 true， is_seller_percent 才能设置为 true
' is_has_household ' => false , // 是否拥有出资户，只有拥有出资户，商家才能贴息，否则只能用户贴息
' is_seller_percent ' => false , // 是否商家贴息
// 花呗分期开启订单传参贴息活动（不支持 PC 支付，无论是国际还是国内的交易都不支持）
// 因此相比 app 支付，不能传递 is_order_subsidy 参数
],
// '_only_args' => true // 只需要返回参数模式时增加
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> web ( $ order );
return $ globalPay -> send ();
// 如果设置了 `_only_args` 为 true，则使用以下方法获取所有的参数
// var_dump($globalPay->getContent());
}
public function wap ()
{
$ order = [
' out_trade_no ' => time (),
' subject ' => '交易 alex ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => 5.45 ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '交易费用^1 ' ,
' total_quantity ' => 1
], 256 ),
' hb_fq_param ' => [
' num ' => 3 , // 花呗分期分期数，只支持 3、6、12 期
// 只有 is_has_household 为 true， is_seller_percent 才能设置为 true
' is_has_household ' => false , // 是否拥有出资户，只有拥有出资户，商家才能贴息，否则只能用户贴息
' is_seller_percent ' => false , // 是否商家贴息
// 花呗分期开启订单传参贴息活动（不支持 PC 支付，无论是国际还是国内的交易都不支持）
// 因此相比 app 支付，不能传递 is_order_subsidy 参数
],
// '_only_args' => true // 只需要返回参数模式时增加
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> wap ( $ order );
return $ globalPay -> send ();
// 如果设置了 `_only_args` 为 true，则使用以下方法获取所有的参数
// var_dump($globalPay->getContent());
}
public function app ()
{
$ order = [
' out_trade_no ' => time (),
' subject ' => '交易 alex ' ,
' currency ' => ' JPY ' ,
' rmb_fee ' => 3.45 ,
' trade_information ' => json_encode ([
' business_type ' => 4 ,
' goods_info ' => '交易费用^1 ' ,
' total_quantity ' => 1
], 256 ),
' hb_fq_param ' => [
' num ' => 3 , // 花呗分期分期数，只支持 3、6、12 期
// 只有 is_has_household 为 true， is_seller_percent 才能设置为 true，否则 is_seller_percent 只能设置为 false
' is_has_household ' => false , // 是否拥有出资户，只有拥有出资户，商家才能贴息，否则只能用户贴息
' is_seller_percent ' => false , // 是否商家贴息， true 为商家贴息， false 为用户贴息
' is_order_subsidy ' => false , // 是否开启订单传参贴息活动
// 出资户贴息和订单传参贴息只能允许一个为 true
],
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> app ( $ order );
$ content = $ globalPay -> getContent ();
var_dump ( $ content );
}
public function find ()
{
// out_trade_no 和 trade_no 参数可以同时含有，也可以二选一
$ order = [
' out_trade_no ' => ' alex_1629950066 ' ,
// 'trade_no' => '2021082622001364941434754996',
' is_hbfq ' => true , // 该笔订单是否为花呗分期支付，订单查询出来的结果会含有 hb_fq_num 参数，不是花呗分期订单则没有这个参数
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> find ( $ order );
var_dump ( $ globalPay -> toArray ());
}
public function refund ()
{
// 花呗分期退款和非花呗分期退款操作流程一致
$ order = [
' out_return_no ' => ' alex_refund_ ' . time (),
' out_trade_no ' => ' alex_1629950066 ' ,
' return_rmb_amount ' => 3.45 ,
' currency ' => ' JPY ' ,
' reason ' => '退款测试' ,
// 'is_sync' => 'N', // 如果 is_sync => N 则开启异步通知，否则不开启异步通知，不开启异步通知 notify_url 参数将会失效（不需要开启时，则不需要设置）
// 'notify_url' => 'http://api.demo.com:8016/v2/alipay/forexNotify', // $order['notify_url'] 设置了，则使用 $order['notify_url'] 的值，否则使用配置文件中的 notify_url 参数
// 'type' => 'pc', // 如果是网站支付，则需要设置 type 参数为 pc，手机浏览器或支付宝钱包支付时，不需要设置
];
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> refund ( $ order );
var_dump ( $ globalPay -> toArray ());
}
public function return ()
{
$ data = GlobalPay:: alipay ( $ this -> config )-> verify ();
}
public function notify ()
{
$ globalPay = GlobalPay:: alipay ( $ this -> config );
try {
$ data = $ globalPay -> verify (); // 验签
// 建议必须对以下几个参数进行业务逻辑验证
$ outTradeNo = $ data -> get ( ' out_trade_no ' ); // 商户需要验证该通知数据中的 out_trade_no 是否为商户系统中创建的订单号。
$ tradeStatus = $ data -> get ( ' trade_status ' ); // 在支付宝的业务通知中，只有交易通知状态为 TRADE_FINISHED 时，支付宝才会认定为买家付款成功。
$ totalFee = $ data -> get ( ' total_fee ' ); // 该笔订单的总金额。请求时对应的参数，原样通知回来。（外币金额）
Log:: debug ( ' GlobalPay Notify ===> ' , $ data -> all ());
} catch ( Exception $ exception ) {
Log:: error ( '异步通知异常 ===> ' . $ exception -> getMessage ());
return $ globalPay -> fail ()-> send (); // 其他框架
// return $globalPay->fail(); // Laravel 框架可以直接这样
}
return $ globalPay -> success ()-> send (); // 其他框架
// return $globalPay->success(); // Laravel 框架可以直接这样
}
/**
* 获取花呗分期计费情况
*/
public function getHbFqCost ()
{
$ totalAmount = 100.88 ;
// 只需要获取 3 6 12 期相对应到还款数
// $globalPay = GlobalPay::alipay($this->config)->getHbFqCost($totalAmount);
// 获取 3 6 12 期相对应到还款数且显示出每一期的还款情况（用户承担所有的手续费）
// $globalPay = GlobalPay::alipay($this->config)->getHbFqCost($totalAmount, true);
// 获取 3 6 12 期相对应到还款数且显示出每一期的还款情况（商家承担所有的手续费）
// $globalPay = GlobalPay::alipay($this->config)->getHbFqCost($totalAmount, true, true);
// 花呗分期计算费率，参见：https://opendocs.alipay.com/open/277/105952?ref=api
$ customerRates = [
0 => [ // 用户承担手续费
3 => 0.023 ,
6 => 0.045 ,
12 => 0.075
],
100 => [ // 商家承担手续费
3 => 0.018 ,
6 => 0.045 ,
12 => 0.075
]
];
// 允许自己传入花呗分期费率（支付宝做活动时，费率可能会有变化）
$ globalPay = GlobalPay:: alipay ( $ this -> config )-> getHbFqCost ( $ totalAmount , true , false , $ customerRates );
var_dump ( $ globalPay -> toArray ());
}
}이 창고 아키텍처 아이디어는 "Yansongda/Pay"를 기반으로합니다. 유용한 PHP 결제 SDK 확장 패키지를 제공 한 패키지의 저자에게 감사드립니다!
MIT
