nextpaygroup/payon-php-sdk

PayOn SDK 是用于网站/应用程序支持的支付解决方案：ATM、二维码、Visa/Mastercard/JCB 等

维护者

详细信息

github.com/nextpaygroup/payon-php-sdk

主页

源代码

问题

安装: 135

依赖: 0

建议者: 0

安全性: 0

星标: 7

关注者: 1

分支: 0

公开问题: 0

v1.0.5 2022-10-28 09:31 UTC

Requires

  • php: >=5.6.0

MIT d4570dc441f0ac5210f7558c6e389d6c1041b401

  • devteampayon <kythuat.woop@payon.vn>

paymentpayon

This package is auto-updated.

Last update: 2024-09-19 12:19:53 UTC

README

  • 该包支持根据文档执行API：[https://docs.nextpay.vn](https://docs.nextpay.vn)
    • 立即支付
    • 获取支持使用二维码支付的银行列表
    • 使用二维码支付
    • 获取支持分期支付的银行列表
    • 分期付款信息
    • 创建分期付款请求
    • 检查交易

安装和加载

使用 composer 安装

composer require nextpaygroup/payon-php-sdk

包含到 PHP 文件中

<?php
use Payon\PaymentGateway\PayonHelper;
//or require
require 'path/to/payon-php-sdk/src/PayonHelper.php';

代码示例

  • 传递给 PayonHelper 函数的参数

    • $mc_id: MC_ID - 商户 ID，用于在 PayOn 上标识客户
    • $app_id: APP_ID - 应用程序 ID，用于标识集成应用程序
    • $secret_key: MC_SECRET_KEY - 用于在业务函数中对数据参数进行加密的密钥
    • $url: URL_API - API 路径
    • $http_auth: MC_AUTH_USER - 基础 Auth 名称
    • $http_auth_pass: MC_AUTH_PASS - Http Auth 基础密码

  • 立即支付

<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$data = [
    "merchant_request_id" => $merchant_request_id,  //Type String: Mã đơn hàng Merchant được tạo từ yêu cầu thanh toán
    "amount" => 10000, //Type Int: Giá trị đơn hàng. Đơn vị: VNĐ
    "description" => 'Thanh toán đơn hàng KH Tran Van A', //Type String: Mô tả thông tin đơn hàng
    "url_redirect" => 'https://payon.vn/', //Type String: Đường link chuyển tiếp sau khi thực hiện thanh toán thành công
    "url_notify" => 'https://payon.vn/notify', //Type String: Đường link thông báo kết quả đơn hàng
    "url_cancel" => 'https://payon.vn/cancel', //Type String: Đường link chuyển tiếp khi khách hàng hủy thanh toán
    "customer_fullname" => 'Tran Van A', //Type String: Họ và tên khách hàng
    "customer_email" => 'tranvana@payon.vn', //Type String: Địa chỉ email khách hàng
    "customer_mobile" => '0123456789', //Type String: Số điện thoại khách hàng
];
$response = $payon->CreateOrderPaynow($data);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 获取支持使用二维码支付的银行列表
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$response = $payon->GetQrBankCode();
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 通过二维码创建支付请求
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$data = [
    "merchant_request_id" => $merchant_request_id,  //Type String: Mã đơn hàng Merchant được tạo từ yêu cầu thanh toán
    "amount" => 10000, //Type Int: Giá trị đơn hàng. Đơn vị: VNĐ
    "description" => 'Thanh toán đơn hàng KH Tran Van A', //Type String: Mô tả thông tin đơn hàng
    "bank_code" => "TCB", //Type String: Mã ngân hàng thanh toán.
    "url_redirect" => 'https://payon.vn/', //Type String: Đường link chuyển tiếp sau khi thực hiện thanh toán thành công
    "url_notify" => 'https://payon.vn/notify', //Type String: Đường link thông báo kết quả đơn hàng
    "url_cancel" => 'https://payon.vn/cancel', //Type String: Đường link chuyển tiếp khi khách hàng hủy thanh toán
    "customer_fullname" => 'Tran Van A', //Type String: Họ và tên khách hàng
    "customer_email" => 'tranvana@payon.vn', //Type String: Địa chỉ email khách hàng
    "customer_mobile" => '0123456789', //Type String: Số điện thoại khách hàng
];
$response = $payon->CreateQRCode($data);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 获取支持分期支付的银行列表
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$response = $payon->GetBankInstallment();
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 分期付款信息
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$data = [
    "amount" => 10000000, //Type Int: Giá trị đơn hàng. Đơn vị: VNĐ
    "bank_code" => "TCB", //Type String: Mã ngân hàng thanh toán.
    'cycles' => [3,6,9], // Type Array: truyền 1 mảng các kỳ thanh toán dạng số.
    'card_type' => "VISA" //Type String: Loại thẻ thanh toán:VISA, MASTERCARD, JCB.
];
$response = $payon->GetFee($data);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 创建分期付款请求
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$data = [
    "merchant_request_id" => $merchant_request_id,  //Type String: Mã đơn hàng Merchant được tạo từ yêu cầu thanh toán
    "amount" => 10000, //Type Int: Giá trị đơn hàng. Đơn vị: VNĐ
    "description" => 'Thanh toán đơn hàng KH Tran Van A', //Type String: Mô tả thông tin đơn hàng
    "bank_code" => "DAB", //Type String: Mã ngân hàng thanh toán.
    "cycle" => 3, // Type Int: Số kỳ (tháng) trả góp.
    "card_type" => "VISA" //Type String: Loại thẻ thanh toán:VISA, MASTERCARD, JCB.
    "userfee" => 1, //Type Int:	Chọn người chịu phí: 1. Người mua chịu phí thanh toán 2. Người bán chịu phí thanh toán.
    "url_redirect" => 'https://payon.vn/', //Type String: Đường link chuyển tiếp sau khi thực hiện thanh toán thành công
    "url_notify" => 'https://payon.vn/notify', //Type String: Đường link thông báo kết quả đơn hàng
    "url_cancel" => 'https://payon.vn/cancel', //Type String: Đường link chuyển tiếp khi khách hàng hủy thanh toán
    "customer_fullname" => 'Tran Van A', //Type String: Họ và tên khách hàng
    "customer_email" => 'tranvana@payon.vn', //Type String: Địa chỉ email khách hàng
    "customer_mobile" => '0123456789', //Type String: Số điện thoại khách hàng
];
$response = $payon->CreateOrderInstallment($data);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 获取支持的支付方式列表
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$response = $payon->getServices();
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 创建 V2 支付请求
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$data = [
    'service_code' => 'PAYNOW_ATM_ON', //Type String: Mã dịch vụ thanh toán được lấy từ $payon->getServices()['data']['service']['code']. VD: $payon->getServices()['data'][1]['service'][1]['code']
    'method_code' => 'ATM', //Type String: Mã phương thức thanh toán được lấy từ $payon->getServices()['data']['service']['support']['code']. VD: $payon->getServices()['data'][1]['service'][1]['support']['code']
    "merchant_request_id" => $merchant_request_id,  //Type String: Mã đơn hàng Merchant được tạo từ yêu cầu thanh toán
    "amount" => 10000, //Type Int: Giá trị đơn hàng. Đơn vị: VNĐ
    'bank_code' => 'TCB', //Type String: Mã phương thức thanh toán được lấy từ $payon->getServices()['data']['service']['support']['banks']['code']
    "description" => 'Thanh toán đơn hàng KH Tran Van A', //Type String: Mô tả thông tin đơn hàng
    "url_redirect" => 'https://payon.vn/', //Type String: Đường link chuyển tiếp sau khi thực hiện thanh toán thành công
    "url_notify" => 'https://payon.vn/notify', //Type String: Đường link thông báo kết quả đơn hàng
    "url_cancel" => 'https://payon.vn/cancel', //Type String: Đường link chuyển tiếp khi khách hàng hủy thanh toán
    "customer_fullname" => 'Tran Van A', //Type String: Họ và tên khách hàng
    "customer_email" => 'tranvana@payon.vn', //Type String: Địa chỉ email khách hàng
    "customer_mobile" => '0123456789', //Type String: Số điện thoại khách hàng
];
$response = $payon->createOrderV2($data);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 检查交易以更新订单状态
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$merchant_request_id = $merchant_request_id  //Type String: Mã đơn hàng Merchant được tạo từ yêu cầu thanh toán
$response = $payon->CheckPayment($merchant_request_id);
if($response['error_code'] = "00"){
    // Call API thành công, tiếp tục xử lý
} else {
    //Có lỗi xảy ra check lỗi trả về
}
  • 检查通过 url_notify 返回的 PayOn 请求
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$parameters = json_decode($req->get_body());  //Request được trả về qua url
$response = $payon->ValidateNotify($parameters->data, $parameters->checksum); //Type Boolean
if($response){
    // Request hợp lệ và tiếp tục xử lý
    // Call $payon->CheckPayment($merchant_request_id) để lấy trạng thái đơn hàng mới nhất sau đó sẽ xử lý cập nhật trạng thái đơn hàng
} else {
    // Request không hợp lệ
}
  • Bypass SSL_VERIFYPEER
<?php

use Payon\PaymentGateway\PayonHelper;

$payon = new PayonHelper($mc_id, $app_id, $secret_key, $url, $http_auth, $http_auth_pass);
$payon->ssl_verifypeer = false;