README

#Laravel-Zaptrance

Laravel 用于与 Zaptrance 付款系统协同工作的包。

安装

PHP 5.4+ 或 HHVM 3.3+，以及 Composer 是必需的。

要获取 Laravel Zaptrance 的最新版本，只需要求它

composer require zaptrance/payment

或者将以下行添加到您的 composer.json 文件的 require 块中。 ... "zaptrance/payment ... 然后您需要运行 composer install 或 composer update 来下载它并更新自动加载器。

一旦 Laravel Zaptrace 安装完成，您需要注册服务提供者。打开 config/app.php 并将以下内容添加到 providers 键。如果您使用 Laravel >= 5.5，则可以跳过此步骤并转到 [配置]。

• Zaptrance\Payment\ZaptranceServiceProvider::class,

此外，还可以这样注册 Facade

'aliases' => [
    ...
    "Zaptrance"=> Zaptrance\Payment\Facades\Zaptrance::class,
    ...
]

配置

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Zaptrance\Payment\ZaptranceServiceProvider"

一个名为 zaptrance.php 的配置文件，其中包含一些合理的默认值，将放置在您的 config 目录中

<?php

return [

    /**
     * Merchant API Key From Zaptrance Merchant Dashboard
     *
     */
    "apiKey"=> 'MERCHANT_API_KEY',


    /**
     * Merchant ID From Zaptrance Merchant Dashboard
     *
     */
    "merchantId" => 'MERCHANT_ID',

    /**
     * Zaptrance Payment URL
     *
     */
    "requestUrl"=>'REQUEST_URL'

];

## 一般付款流程

尽管有多种支付订单的方式，但大多数支付网关都希望您在结账过程中遵循以下流程

### 1. 客户被重定向到支付提供者 客户完成结账流程并准备付款后，客户必须被重定向到支付提供者的网站。

通过提交包含一些隐藏字段的表单来实现重定向。表单必须提交到支付提供者的网站。隐藏字段至少指定必须支付的金额、订单 ID 和散列值。

### 2. 客户在支付提供者的网站上支付 客户到达支付提供者的网站并可以选择支付方式。支付订单所需的全部步骤都由支付提供者处理。

### 3. 客户被重定向回 客户支付订单后，将被重定向回。在重定向请求到商店网站上，会返回一些值。通常包括订单 ID、支付结果和散列值。

散列值是通过返回的字段和秘密的非公开值计算出来的。此散列值用于验证请求是否有效且来自支付提供者。彻底检查此散列值至关重要。

用法

打开您的 config/zaptrance 文件，并添加您的 MERCHANT_API_KEY、MERCHANT ID 和付款 URL

MERCHANT_API_KEY=xxxxxxxxxxxxx
MERCHANT_ID=xxxxxxxxxxxxx
REQUEST_URL=https://

设置路由和控制器方法

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Http\Requests;
use App\Http\Controllers\Controller;
use Zaptrance;

class PaymentController extends Controller
{

    /**
     * Redirect the User to Zaptrance Payment Page
     * @return Url
     */
    public function makePayment()
    {
    	/**
			$service_id is the id of the Service The transaction is made for 
			Its from Service Dashboard
    	*/
        return return Zaptrance::makePayment($serviceid)->redirectNow();
    }

    /**
     * Obtain Paystack payment information
     * @return void
     */

}

示例表单如下所示

<form method="POST" action="{{ Your Payment Route}}" accept-charset="UTF-8" class="form-horizontal" role="form">
        <div class="row" style="margin-bottom:40px;">
          <div class="col-md-8 col-md-offset-2">
            <p>
                <div>
                    Lagos Eyo Print Tee Shirt
                    ₦ 2,950
                </div>
            </p>
            <input type="hidden" name="amount" value="2950">
                    <input type="hidden" name="transaction_id" value="" >
                    <input type="hidden" name="email" value="Kss.com">
                    <input type="hidden" name="service_token" value="Zaptrance Service Key">
                    <input type="submit"  value="Pay" class="btn btn-primary">


            <p>
              <button class="btn btn-success btn-lg btn-block" type="submit" value="Pay Now!">
              <i class="fa fa-plus-circle fa-lg"></i> Pay Now!
              </button>
            </p>
          </div>
        </div>
</form>