zepson/dpo-laravel

一个简单的包,用于将DPO API添加到您的Laravel应用程序中,使支付处理变得更加简单

V1.0.4 2022-05-11 10:04 UTC

This package is auto-updated.

Last update: 2024-09-05 21:27:51 UTC


README

最好的DPO Laravel包,简单至极

Build Status

这个包将帮助您将DPO支付API添加到Laravel应用程序中,我们欢迎贡献和支持,使其变得更好。

特性

  • 创建支付令牌(在DPO服务器上启动订单)
  • 验证支付令牌(检查交易状态)
  • 直接支付(将订单直接重定向到DPO支付页面)
  • 获取支付令牌
  • 数据库迁移以保存交易详情
  • 易于使用
  • 不断更新

工作原理

  1. 创建支付令牌
  2. 验证令牌
  3. 重定向到DPO支付页面
  4. 获取响应
  5. 完成

这个包在幕后为您完成所有这些😂

基本用法示例。

<?php

use Zepson\Dpo\Dpo;


$dpo = new Dpo();
$order = [
    'paymentAmount' => "10000",
    'paymentCurrency' => "TZS",
    'customerFirstName' => "Novath",
    'customerLastName' => "Thomas",
    'customerAddress' => "Tanzania",
    'customerCity' => "Dodoma",
    'customerPhone' => "0752771650",
    'customerEmail' => "novath@zepson.co.tz",
    'companyRef' => "34TESTREFF"
];
// Now make  payment
$dpo->directPayment($data);
// Its done!  Simple right! 😂

安装

通过Composer安装包

composer require zepson/dpo-laravel

现在您可以发布配置文件和迁移

php artisan vendor:publish --provider="Zepson\Dpo\DpoServiceProvider" --tag="dpo-laravel-migrations"

迁移数据库表 [可选]

php artisan migrate

配置文件

<?php
return [
    "company_token" => env("DPO_COMPANY_TOKEN", "9F416C11-127B-4DE2-AC7F-D5710E4C5E0A"),
    "account_type" => env("DPO_ACCOUNT_TYPE", "3854"),
    'is_test_mode' => env("DPO_IS_TEST_MODE", true),
    "back_url" => env("DPO_BACK_URL"),
    "redirect_url" => env("DPO_REDIRECT_URL")
];

以上详情是从DPO公共文档中获取的测试/沙盒环境详细信息

更新.env文件,并填写正确信息

DPO_COMPANY_TOKEN = "YOUR_DPO_COMPANY_TOKEN"
DPO_ACCOUNT_TYPE = "YOUR_DPO_ACCONT_TYPE"
DPO_IS_TEST_MODE = "true"  # true|false
DPO_BACK_URL ="YOUR_APPLICATION_BACK_URL"
DPO_REDIRECT_URL =  "APPLICATION_REDIRECT_URL_AFTER_RESPONSE_FROM_DPO"

用法

  • 创建一个数组,其中包含您的订单,与以下示例中的参数匹配
$order = [
    'paymentAmount' => "10000",
    'paymentCurrency' => "TZS",
    'customerFirstName' => "Novath",
    'customerLastName' => "Thomas",
    'customerAddress' => "Tanzania",
    'customerCity' => "Dodoma",
    'customerPhone' => "0752771650",
    'customerEmail' => "novath@zepson.co.tz",
    'companyRef' => "34TESTREFF"
];
  • 现在您可以选择直接支付或先创建令牌然后支付
  • 从直接支付开始
$dpo = new Dpo;
return $dpo->directPayment($data); // this will redirect user to DPO Payment page
  • 如果您想保存详情,那么这是理想的一步 [生成令牌,支付]
  • 获取令牌
$token = $dpo->createToken($data); // return array of response with transaction code
// you can save or do what ever you want with the response
  • 获取支付URL
$dpo->getPaymentUrl($token);
  • 将用户重定向到支付页面
return Redirect::to($payment_url);

正如[Novath Thomas]经常说的

系统安全与复杂性的差异很大,复杂性会伤害,API不应该复杂。这就是引入API的主要目标之一

我们希望有更多的贡献,使这个包更加安全和易于阅读。

许可证

本项目采用MIT许可证。