global pay
1.1.2
SDK PHP yang mendukung pembayaran internasional saat ini hanya didukung oleh Alipay International Version . Karena layanan pembayaran online lintas batas Alipay hanya mendukung empat jenis: Deklarasi Aplikasi, WAP, Web dan Bea Cukai, SDK ini menyediakan tiga pembayaran lintas batas: App, WAP, dan Web. Untuk detailnya, silakan merujuk ke dokumen pembayaran internasional Alipay resmi.
Tujuan asli untuk membuat gudang ini adalah bahwa unit saya saat ini saat ini memiliki kebutuhan untuk pembayaran lintas batas. Pembayaran domestik selalu mengadopsi paket ekspansi Yansongda/Pay dan digunakan untuk metode panggilan ini. Namun, karena paket Anda tidak mendukung pembayaran di luar negeri untuk saat ini, saya hanya dapat menyingsingkan lengan baju saya dan menulisnya sendiri. Saya hanya ingin paket ekspansi ini digunakan secara internal untuk tim, tetapi baru -baru ini seorang teman kebetulan bertanya kepada saya paket ekspansi apa yang akan digunakan untuk pembayaran di luar negeri, jadi saya berpikir untuk membuka sumber paket ini untuk referensi oleh semua siswa! Jika Anda menemukan bug di paket ini, jangan ragu untuk menyebutkan PR. Saya berharap semua siswa dapat menggunakannya dengan bahagia!
Fungsi dalam paket ekspansi ini hanya dimaksudkan untuk diperluas berdasarkan kebutuhan unit tempat Anda berada. Oleh karena itu, pembayaran alipay lintas batas hanya dipertimbangkan untuk saat ini, dan yang lain tidak akan dipertimbangkan untuk saat ini.
composer require pudongping/global-pay -vvvhttps://pudongping.github.io/global-pay-doc
| metode | menggambarkan |
|---|---|
| web | Pembayaran komputer |
| wap | Pembayaran Situs Web Seluler |
| aplikasi | Pembayaran Aplikasi |
temukan (array | string $ order)
Deskripsi: Temukan antarmuka pesanan
Parameter: Ketika $order adalah tipe string , silakan lewati nomor pesanan sistem, sesuai dengan parameter out_trade_no di alipay lintas batas; Saat tipe array , silakan merujuk ke dokumen kueri Pesanan Luar Negeri Alipay untuk parameter.
Return: Kueri berhasil, dan contoh IlluminateSupportCollection dapat diakses melalui $collection->toArray() , $collection->all() atau $collection->get('field') .
Pengembalian dana (array $ pesanan)
Deskripsi: Antarmuka pengembalian dana
Parameter: $order , silakan merujuk ke dokumen Antarmuka Pengembalian Uang Alipay Overseas untuk parameter pengembalian dana.
Pengembalian: Pengembalian dana berhasil, dan contoh IlluminateSupportCollection dapat diakses melalui $collection->toArray() , $collection->all() atau $collection->get('field') .
memeriksa()
Deskripsi: Verifikasi apakah data yang dikembalikan oleh server legal
Return: Verifikasi berhasil, dan instance IlluminateSupportCollection dapat diakses melalui $collection->toArray() , $collection->all() atau $collection->get('field') .
getExchangerate ()
Deskripsi: Dapatkan nilai tukar. Untuk detailnya, silakan merujuk ke antarmuka kueri nilai tukar alipay di luar negeri.
Return: Dapatkan sukses, kembalikan contoh IlluminateSupportCollection , dan Anda dapat mengakses data yang dikembalikan oleh server melalui $collection->toArray() atau $collection->all() atau $collection->get('field') .
Catatan: 1. Nilai tukar antara mata uang akan berubah sekali antara jam 9:00 dan 11:00 waktu Beijing setiap hari; 2. Akuisisi maksimum maksimum nilai tukar adalah 100 kali. (Mungkin perlu untuk mempertimbangkan menghemat nilai tukar melalui cache untuk mencegah kelainan pada antarmuka, karena SDK ini tidak melakukan pemrosesan cache)
gethbfqcost (float $ totalamount, bool $ isShowall = false, bool $ issellerpercent = false)
Deskripsi: Dapatkan situasi penagihan angsuran huabei
Parameter: $totalAmount adalah kepala sekolah dari angsuran, $isShowAll adalah apakah akan menampilkan jumlah pembayaran dari setiap periode, $isSellerPercent adalah true , yang berarti bahwa pedagang menanggung semua biaya penanganan, dan false berarti bahwa pengguna menanggung semua biaya penanganan.
Return: Dapatkan sukses, kembalikan contoh IlluminateSupportCollection , dan Anda dapat mengakses data yang dikembalikan oleh server melalui $collection->toArray() atau $collection->all() atau $collection->get('field') .
Kembali ke deskripsi parameter
| parameter | arti |
|---|---|
| nper | Jumlah periode |
| Total_amount Total_amount | kepala sekolah |
| Total_charge | Total biaya penanganan |
| kecepatan | suku bunga |
| per_charge | Setiap periode biaya penanganan |
| per_amount | Jumlah pokok untuk setiap periode |
| per_total_amount | Total biaya per periode |
| Refund_list | Daftar Pembayaran |
| refund_list.nper | Masalah mana |
| refund_list.charge | Biaya penanganan yang diperlukan untuk periode saat ini |
| refund_list.amount | Jumlah pokok yang harus dibayar untuk periode saat ini |
| refund_list.current_total_amount | Total biaya yang diperlukan untuk periode saat ini |
<?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 ());
}
}Gagasan arsitektur gudang ini didasarkan pada "Yansongda/Pay". Terima kasih kepada penulis paket Anda untuk menyediakan paket ekstensi SDK pembayaran PHP yang berguna!
Mit
