README

• 支持执行以下文档中的API的包：[https://docs.nextpay.vn](https://docs.nextpay.vn) (外部链接)
  • 立即支付
  • 通过QR-Code获取支持的银行支付列表
  • 通过QR-Code支付
  • 获取支持分期支付的银行列表
  • 分期支付费用信息
  • 创建分期支付请求
  • 检查交易

安装和加载

使用composer安装

composer require payon/paymentgateway

将包包含到PHP文件中

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

代码示例

• 传递给PayonHelper函数的参数
  • $mc_id: MC_ID - 商户ID，用于在PayOn上识别客户
  • $app_id: APP_ID - 应用ID，用于识别集成应用
  • $secret_key: MC_SECRET_KEY - 密钥，用于在业务函数中加密data参数
  • $url: URL_API - API路径
  • $http_auth: MC_AUTH_USER - 基本认证的用户名
  • $http_auth_pass: MC_AUTH_PASS - 基本认证的密码
• 立即支付

<?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ề
}

• 通过QR-Code获取支持的银行支付列表

<?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ề
}

• 使用QR-Code创建支付请求

<?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" => 10000, //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, // Type Int: Số kỳ (tháng) trả góp.
    '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);
$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ề
}

• 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;