imnpc/laravel-allinpay

An Allinpay(Tonglian) PHP SDK For Laravel

1.0.7 2024-04-22 01:55 UTC

Requires

• guzzlehttp/guzzle: ^7
• mockery/mockery: ^1.2
• phpunit/phpunit: ~9

MIT

• VAGH

README

针对 通联支付 接口定制的适用于 Laravel 框架的 SDK

Installing

$ composer require imnpc/laravel-allinpay -vvv

Usage

在 Laravel 环境中这样使用：

在 Laravel 中使用也是同样的安装方式，配置写在 config/services.php 中：

'tongLianPay' => [
    'app_id'      => env('TONGLIAN_APP_ID'),
    'cus_id'      => env('TONGLIAN_CUS_ID'),
    'app_version' => env('TONGLIAN_API_VERSION', 11),
    'is_test'     => env('TONGLIAN_IS_TEST', true)
],

然后在 .env 中配置对应的配置项。

可以用两种方式来获取 Vagh\LaravelAllInPay\AllInPay 实例：

// 依赖注入
use Vagh\LaravelAllInPay\AllInPay as TongLianPay;
use Vagh\LaravelAllInPay\Exceptions\Exception;
use Vagh\LaravelAllInPay\Exceptions\HttpException;
use Vagh\LaravelAllInPay\Exceptions\InvalidArgumentException;
use Vagh\LaravelAllInPay\Exceptions\ServiceException;

protected $pay_sdk;

public function __construct(TongLianPay $pay_sdk)
{
    $this->pay_sdk = $pay_sdk;
}

public function createOrder()
{
    try {
        $params = [];
        $result = $this->pay_sdk->payJSApi($params);

        var_dump($result);exit;
    } catch (Exception $e) {

        $message = '未知错误：'.$e->getMessage();

        if ($e instanceof HttpException) {
            $message = '请求接口失败：'.$e->getMessage();
        }
        if ($e instanceof InvalidArgumentException) {
            $message = '接口参数错误：'.$e->getMessage();
        }
        if ($e instanceof ServiceException) {
            $message = '业务处理错误：'.$e->getMessage();
        }

        throw new \Exception($message, $e->getCode());
    }
}

// 服务名访问
public function edit() 
{
    $params = []; // 请参照文档填写参数
    $response = app('tongLianPay')->payJSApi($params);
}

不在 Laravel 环境下可以这样使用：

<?php
require __DIR__ . '/vendor/autoload.php';

use Vagh\LaravelAllInPay\AllInPay;
use Vagh\LaravelAllInPay\Exceptions\HttpException;
use Vagh\LaravelAllInPay\Exceptions\InvalidArgumentException;
use Vagh\LaravelAllInPay\Exceptions\ServiceException;

$config = [
    'app_id'      => '00000051',
    'cus_id'      => '990440148166000',
    'app_version' => '11',
    'is_test'     => true
];

$pay = new AllInPay($config);

// 测试统一下单(JS SDK)
try {

    $params = [
        'amount'       => '10',
        'out_trade_no' => 'CJXEWIOJOIDUXOUWOEICXNUWEO',
        'open_id'      => 'oTod4wA_AgM40UV2uQ9KJ-sgGmgU',
        'notify_url'   => 'http://test.com',
        'app_id'       => '748923478923'
    ];

    $result = $pay->payJSApi($params);

    var_dump($result);

} catch (Exception $e) {

    if ($e instanceof InvalidArgumentException) {
        $messgae = '参数异常：' . $e->getMessage();
    }
    if ($e instanceof HttpException) {
        $messgae = '通信异常：' . $e->getMessage();
    }
    if ($e instanceof ServiceException) {
        $messgae = '业务逻辑异常：' . $e->getMessage();
    }
    
    var_dump($messgae);
}

// 测试退款
try {
    $params = [
        'amount'           => '10',
        'order_history_id' => 'CJXEWIOJOIDUXOUWOEICXNUWEO',
        'out_trade_no'     => 'oTod4wA_AgM40UV2uQ9KJ-sgGmgU',
    ];

    $result = $pay->refundPay($params);

    var_dump($result);

} catch (Exception $e) {

    if ($e instanceof InvalidArgumentException) {
        $messgae = '参数异常：' . $e->getMessage();
    }
    if ($e instanceof HttpException) {
        $messgae = '通信异常：' . $e->getMessage();
    }
    if ($e instanceof ServiceException) {
        $messgae = '业务逻辑异常：' . $e->getMessage();
    }

    var_dump($messgae);
}

统一支付接口(微信 JS SDK)

具体参数详情请以及接口返回值请参考通联支付的官方文档

参数	说明	必传
open_id	对应微信支付的发起用户ID	是
notify_url	支付回调地址	是
app_id	微信对应的 AppID	是
amount	需要支付的金额 单位：分	是
out_trade_no	商户订单号	是
valid_time	订单有效时间	否
true_name	付款人真实姓名	否
id_card_no	证件号	否

退款接口

具体参数详情请以及接口返回值请参考通联支付的官方文档

参数	说明	必传
open_id	对应微信支付的发起用户ID	是
amount	需要支付的金额 单位：分	是
out_trade_no	商户订单号	是
remark	备注信息 最多25字	否

Contributing

You can contribute in one of three ways:

1. File bug reports using the issue tracker.
2. Answer questions or fix bugs on the issue tracker.
3. Contribute new features or update the wiki.

The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

License

MIT