README

Sadad 支付平台

Sadad 是一个卡塔尔平台，通过在线[商店/网站/门户]和移动[应用程序]进行发送/接收支付。

以下是一个完整的功能列表

网页结账
API 集成
- 交易 - 列出交易
- 交易 - 获取单个交易
- 交易 - 退款交易

关于 Applab

AppLab 是一家领先的在线平台开发公司。在线平台包括后端、数据库、Web 应用程序和移动。

关于 Sadad 平台

Sadad Sadad 是一个卡塔尔平台，通过在线发送/接收支付。

安装 Applab Sadad

推荐通过 Composer 安装 Applab Sadad。

composer require applab/sadad

发布配置和迁移

php artisan vendor:publish --provider="Applab\Sadad\SadadServiceProvider"

服务提供者通过包发现自动加载。

使用方法

配置

该软件包附带一个名为 applab-sadad.php 的配置文件，在安装过程中发布到配置目录。以下是设置的概述。

sadadId

创建 Sadad 账户时发出

secretKey

注册您的域名时发出

domain

您注册的域名名称

WebCheckout 2.1

客户正在您的网站结账页面上填写详细信息并下订单。

  $webCheckoutOneReq = new WCORequest();     
  $webCheckoutOneReq->total_amount=100;
  $webCheckoutOneReq->order_id = $webCheckoutReq->getOrderId();
  $webCheckoutOneReq->customer_mobile = "974XXXXXXXX";
  $webCheckoutOneReq->callback_url = url('sadad-purchased/'.$webCheckoutReq->order_id);      
  $products[] = [
    'id' => 123,
    'title' => "product name",
    'quantity' => 1,
    'amount' => 1,
    'type' => 'line_item'
  ];
  $webCheckoutOneReq->setProducts($products);
  return Sadad::webCheckoutOne($webCheckoutOneReq); //default view

在验证 CSRF Token 中间件中排除您的回调 URL 以获取 SADAD 的 post 响应

商户集成 API

交易列表

  $filters = [];
  Sadad::getTransactions($filter)

交易详情

  Sadad::getTransaction('SD33XXXXXXXXXX8')

交易退款

  Sadad::refundTransaction('SD33XXXXXXXXXX8')

发票列表

  $filters = [];
  Sadad::getInvoices($filter)

创建发票

  $invoiceData = new InvoiceRequest();
  $invoiceData->countryCode = '974';
  $invoiceData->cellnumber = '66XXXXXX';
  $invoiceData->clientname = 'Client name';
  // Status for Invoice
  // 1 - Draft, 2 - Unpaid, 3 - Paid, 4 - Overdue, 5 - Cancelled
  $invoiceData->status = 2;
  $invoiceData->remarks = 'Invoice test remarks';
  $invoiceData->amount = 100; // Total amount in QR

  // Invoice can have many item
  $invoice_details[] = [
      'description' => 'Testing 123',
      'quantity' => 1,
      'amount' => 100, // Amount for each item
  ];
  $invoiceData->setInvoiceDetails($invoice_details);
  $payload = $invoiceData->preparePayload()->getPayload();

  return Sadad::createInvoice($payload);

分享发票

  // Share using mobile
  $payload = [
    'sentvia' => 4,
    'invoicenumber' => 'SD66XXXXXXXXX8',
    'receivercellno' => '66XXXXXX',
  ];
  // Share using email
  $payload = [
    'sentvia' => 3,
    'invoicenumber' => 'SD66XXXXXXXXX8',
    'receiverEmail' => 'mail@example.com',
  ];

  return Sadad::shareInvoice($payload);

安全漏洞

如果您在此软件包中发现安全漏洞，请通过 manu@applab.qa 发送电子邮件给 Manu Applab。所有安全漏洞都将得到及时解决。

许可证

此软件包是开源软件，根据 MIT 许可证授权。

applab / sadad

维护者

详细信息