README

此包可在Laravel应用中无缝集成Paylink支付网关，并提供方便的方法与Paylink API交互，简化支付处理及相关功能。

安装

您可以通过composer安装paylinksa/laravel包。在终端运行以下命令

composer require paylinksa/laravel

支付服务

环境设置

根据您的环境创建一个PaylinkService实例

• 用于测试

use Paylink\Services\PaylinkService;

$paylinkService = PaylinkService::test();

• 用于生产

use Paylink\Services\PaylinkService;

$paylinkService = PaylinkService::production('API_ID_xxxxxxxxxx', 'SECRET_KEY_xxxxxxxxxx');

方法

1. 添加发票:

   将发票添加到系统中以进行支付处理。

      use Paylink\Models\PaylinkProduct;
   
      $invoiceDetails = $paylinkService->addInvoice(
         amount: 250.0,
         clientMobile: '0512345678',
         clientName: 'Mohammed Ali',
         orderNumber: '123456789',
         products: [
            new PaylinkProduct(title: 'item1', price: 5.0, qty: 10),
            new PaylinkProduct(title: 'item2', price: 20.0, qty: 10)
         ],
         callBackUrl: 'https://example.com',
      );

2. 获取发票

   检索发票详情。

      $invoiceDetails = $paylinkService->getInvoice(transactionNo: '1714289084591');
   
      // $invoiceDetails->orderStatus;
      // $invoiceDetails->transactionNo;
      // $invoiceDetails->url;
      // ...

3. 取消发票

   取消由商家发起的现有发票。

      $paylinkService->cancelInvoice(transactionNo: '1714289084591'); // true-false

示例

• Paylink支付示例
• Paylink支付Webhook（由商家使用）

有关详细使用说明，请参阅Paylink支付服务文档

合作伙伴服务

环境设置

根据您的环境创建一个PartnerService实例

• 用于测试

use Paylink\Services\PartnerService;

$partnerService = PartnerService::test('profileNo_xxxxxxxxxxx', 'apiKey_xxxxxxxxxxxx');

• 用于生产

use Paylink\Services\PartnerService;

$partnerService = PartnerService::production('profileNo_xxxxxxxxxxx', 'apiKey_xxxxxxxxxxxx');

方法

1. 检查许可证

   通过检查商家的许可证信息来启动注册流程的第一步。

      $responseData = $partnerService->checkLicense(
         registrationType: "cr", // freelancer or cr
         licenseNumber: "7014832310",
         mobileNumber: "0512345678",
         hijriYear: "1400",
         hijriMonth: "06",
         hijriDay: "16",
         partnerProfileNo: "07537924"
      );

2. 验证手机号码

   通过确认通过短信收到的OTP来验证商家的手机号码。

      $responseData = $partnerService->validateMobile(
         signature: "ae135f2506dc3c44152d62265419c09e80dec0b108090bc81d6a1a691c3f0647",
         mobile: "0512345678",
         sessionUuid: "96ea8e22-edef-414b-9724-3bd2d494b710",
         otp: "7615",
         partnerProfileNo: "19039481"
      );

3. 添加信息

   添加与商家相关的信息，例如银行详情、业务类别和个人信息。

      $responseData = $partnerService->addInfo(
         mobile: "0500000001",
         sessionUuid: "96ea8e22-edef-414b-9724-3bd2d494b710",
         signature: "ae135f2506dc3c44152d62265419c09e80dec0b108090bc81d6a1a691c3f0647",
         partnerProfileNo: "19039481",
         iban: "SA1231231231312312313213",
         bankName: "AlRajhi Bank",
         categoryDescription: "Any description for the activity of the merchant. It must match the activity of the merchant.",
         salesVolume: "below_10000",
         sellingScope: "domestic",
         nationalId: "1006170383",
         licenseName: '21012451525',
         email: "mohammed@test.com",
         firstName: "Mohammed",
         lastName: "Ali",
         password: "xxxxxxxxxxx",
      );

4. 与Nafath确认账户

   提交所需信息后，与Nafath确认账户。

      $responseData = $partnerService->confirmingWithNafath(
         signature: 'ae135f2506dc3c44152d62265419c09e80dec0b108090bc81d6a1a691c3f0647',
         sessionUuid: '96ea8e22-edef-414b-9724-3bd2d494b710',
         mobile: '0512345678',
         partnerProfileNo: '19039481',
      );

5. 获取我的商家

   检索与合作伙伴账户关联的商家列表。

      $responseData = $partnerService->getMyMerchants();

6. 获取商家密钥

   检索特定子商家的API凭证（API ID和密钥）。

      $responseData = $partnerService->getMerchantKeys(
         searchType: 'cr', // cr, freelancer, mobile, email, accountNo
         searchValue: '20139202930',
         profileNo: '12345687',
      );

示例

• 合作伙伴示例
• 激活Webhook（由合作伙伴使用）

有关详细使用说明，请参阅合作伙伴服务文档

支持

如果您遇到任何问题或对Paylink包有任何疑问，请联系我们。

许可证

此包是开源软件，许可协议为MIT许可证。