en1gm4a/fastpay-bundle

v1.0.0 2024-04-24 20:34 UTC

This package is auto-updated.

Last update: 2024-09-24 21:32:39 UTC


README

当我开始在我的一个项目中使用FastPay API时,我注意到他们没有提供任何PHP包。因此,我决定自己创建一个,以便使事物更加有序且易于集成。请随意使用,以后再感谢我。

根据公司原始的文档编写

功能

  • 启动支付
  • 验证支付
  • 退款支付
  • 退款支付验证

安装

使用composer

composer require en1gm4a/fastpay-bundle

使用

初始化(为后续步骤必需)

 $fastpay = new FastPayAPI("your store id","your store password","deploy mode");
对于部署模式,你可以使用DEPLOYMODE常量,它包括PROD和STAGING

启动支付

    $InitiatePayment = new InitiatePayment();
    $InitiatePayment->setOrderId("24214565");
    $InitiatePayment->setCart("[{\"name\": \"Scarf\", \"qty\": 1, \"unit_price\": 5000, \"sub_total\": 5000}]");
    $InitiatePayment->setBillAmount("1000");
    $InitiatePayment->setCurrency("IQD");
    $fastpay->ExecuteInitiate($InitiatePayment);
它返回InitiatePaymentResponse类的响应类型,包括代码、消息、数据等,可以使用如下方式
$fastpay->ExecuteInitiate($InitiatePayment)->getRedirectUri(); //to get the payment link
$fastpay->ExecuteInitiate($InitiatePayment)->getData(); //response array data
$fastpay->ExecuteInitiate($InitiatePayment)->getCode(); //reponses code (200|422)
$fastpay->ExecuteInitiate($InitiatePayment)->getMessages(); //responses message

验证支付

 $fastpay->ExecuteVPayment("order id");
它返回ValidatePaymentResponse类的响应类型,包括代码、消息、数据,以及响应数据作为对象,如下所示
 $fastpay->ExecuteVPayment("order id")->getMerchantOrderId(); //returns merchant_order_id

退款支付

$fastpay->ExecuteRPayment("orderid","amount","refund secret key","msidn (phone num)")
它返回RefundPaymentResponse类的响应类型,包括代码、消息、数据,以及响应数据作为对象,如下所示
 $fastpay->ExecuteRPayment("orderid","amount","refund secret key","msidn (phone num)")->getRecipientName(); //returns reciepient name

验证退款

 $fastpay->ExecuteVRefund("order id");
它返回ValidateRefundResponse类的响应类型,包括代码、消息、数据,以及响应数据作为对象,如下所示
$fastpay->ExecuteVRefund("order id")->isRefundStatusTrue; //returns true if refund was successful

免责声明

我特此声明,我没有任何形式与FastPay有关联,并且明确否认对它的服务、产品或行为的任何责任。此代码包提供“现状”,不提供任何针对特定目的的保证或保证。用户在使用此代码时,应谨慎行事,并自行承担责任,我对此代码的使用所引起的任何法律问题、损害或后果不承担任何责任。