README

Zepson pay是一种软件即服务支付网关，旨在通过API轻松且方便地将支付集成到任何人的系统中。Zepson工程师致力于解决适合您业务的实际研究。

特性

收款（也包括Android支付）
支出
交易查询（也包括Android支付）
交易撤销
欺诈检测

文档

如何集成到PHP/Laravel应用程序

1.Install Zepson Pay Package
2. Prepare your API key, API secret and environment from zepsonpay.com developer dashboard
3. Create an Instance of ZepsonPay Class
4. Pass Required Parameters
5. Call makePayment to initiate makePayment
6. Call paymentStatus to get transaction paymentStatus

安装

在PHP或Laravel应用程序中使用Composer安装my-project

  composer require zepson/zepsonpay-php

创建Zepson pay类的实例

使用以下说明创建ZepsonPay类的实例。请注意，示例中的参数在初始化类时都是必需的。api_key和api_secret可以从https://zepsonpay.com开发者门户获取。

<?php 

    $api_key = "YOUR_ZEPSONPAY_API_KEY";
    $api_secret = "YOUR_ZEPSONPAY_API_SECRET";
    $environment = "android"; //sandbox, produciton, zepsonpay and android. currently support android (v1.0)
    //creating instance of zepsonpay class.
    $zp = new Zepson\ZepsonpaySDK\ZepsonPay($api_key, $api_secret, $environment);

进行支付

要完成支付，示例中的参数是必需的。支付有时也称为收款。

 
$data = [
    'amount' => 100,
    'purpose' => 'For testing purposes',
    'ext_trxn_reff' => '1JF61RJWOK', //for android transaction this is equal to operators transaction id received after payment
    'phone' => '0688950846', //customer phone
    'operator' => 'vodacom', //operator to charge from
    'device' => '00000000-0000-0000-6da8-08a4x40d4b97' // only for android transactions obtained after registering device in gateway.zepsonsms.co.tz
];

    //make payment
 $response = $zp->makePayment($data);

支付后，请参阅下面的回调部分，了解如何处理API的不同响应。

交易查询（检查交易状态）

要检查状态，示例中的参数是必需的。交易状态有时也称为交易查询。

 
$data = [
    'ext_trxn_reff' => '1JF61RJWOK', //for android transaction this is equal to operators transaction id received after payment
];

    //make payment
 $response = $zp->paymentStatus($data);

收到响应后，请参阅下面的回调部分，了解如何处理API的不同响应。

可用的支付响应助手

我们准备了一份助手列表，以帮助您简化流程，您可以使用此列表处理任何类型的交易/环境。

检查支付是否成功

    $zp->isPaymentSuccess();

这返回以下Zepson pay状态码。

获取完整的交易响应作为数组

    $zp->getFullResponseArray();

获取完整的交易响应作为Json

    $zp->getFullResponseJson();

获取交易ID

    $zp->getTransactionId();

获取外部交易ID

    $zp->getExternalTransactionId();

获取响应消息

    $zp->getMessage();

获取响应交易消息

    $zp->getTransactionMessage();

获取错误

    $zp->getErrors();

ANDROID 交易

这很简单，不需要很多文档，您的集成审批是自动完成的。

您需要在gateway.zepsonsms.co.tz上创建一个账户，转到设备部分并注册您的手机（Android），

创建您的Zepson pay账户并创建您的应用程序，选择业务类别为android，您将获得应用程序ID和应用密钥，使用它们与我们的API集成。

您需要添加设备ID（来自Zepson SMS网关）和您的webhook密钥，通过访问您的gateway.zepsonsms.co.tz账户，工具部分选择webhook，创建webhook，添加URL https://zepsonpay.com/webhook，您将获得webhook密钥，使用它与我们的API集成。

如有疑问，请访问zepsonpay.com