README

Paycorp-Sampath-Vault 是一个用于在 Laravel 和 PHP 项目中使用 Sampath 银行支付网关进行支付的 PHP 包。它使用 Sampath 银行的 PHP 库。在这个包中，您可以进行

• 重定向页面支付
• 实时支付
• Token 化支付

功能！

• 与 composer 一起使用
• 简单集成
• 兼容 Laravel

需求

PHP >= 5.6 OpenSSL >= 1.0.1 CUrl >= 7.34 Composer

用法

安装

$ composer require createch/paycorp-sampath-vault

配置

Laravel

通过 composer 安装后，将以下配置值添加到 .env 文件中

SAMPATH_SERVICE_ENDPOINT=
SAMPATH_AUTHTOKEN=
SAMPATH_HMAC=
SAMPATH_CURRENCY=
SAMPATH_TOKENIZE_CLIENT_ID=
SAMPATH_PURCHASE_CLIENT_ID=
SAMPATH_RETURN_URL=

方法

PaymentInit

在您的类头中导入包类

use createch\PaycorpSampathVault\PaycorpSampathVault;

示例 InitRequest

    $paymentInit = new PaycorpSampathVault();
    $data['clientRef'] = $request->user()->id;
    $data['comment'] = "Your comment";
    $data['total_amount'] = 1010;
    $data['service_fee_amount'] = 1010;
    $data['payment_amount'] = 1010;
    $res = $paymentInit->initRequest($data);
    
    return response()->json($res);

您将收到 reqid 和 payment_page_url 以进行重定向。当您重定向到 "payment_page_url" 时，用户可以输入卡信息并支付。然后 Paycorp 将响应返回到您在 .env 文件中配置的 "SAMPATH_RETURN_URL"。当收到正确的响应时，您需要调用 PaymentCompleteRequest。

completeRequest

    $data['reqid'] = $_GET['reqid'];
    $data['clientRef'] = $_GET['clientRef'];
    $paymentComplete = new PaycorpSampathVault();
    $response = $paymentComplete->completeRequest($data);
    
    return response()->json($res);

使用 Token 进行实时支付

在支付完成响应中，您将获得 "Token" 和必要的数据。使用 "Token" 您可以立即进行支付，而无需输入卡信息或每次将用户重定向到支付页面。这是 Paycorp 中 Vault 的特殊功能。

    $payment = new PaycorpSampathVault();

    $data = [];
    $data['clientRef'] = "Clent Ref";
    $data['token'] = "token";
    $data['comment'] = "Your Comment";
    $data['amount'] = 1010; // in cents
    $data['expire_at'] = "Expiry Date of Card"; //1223
    $data['payment_amount'] = 1010;
    $response = $payment->realTimePayment($data);
    
    return $response;

注意

在使用此包之前，请阅读 Paycorp 技术文档，并熟悉工作流程。此包仅针对开发者，以节省他们的时间。

许可证

MIT

自由软件，太棒了！