README

Composer账号

使用的Composer账号为 carlos.miranda@undostres.com.mx，如有故障排除，请联系。

Composer安装

需要Composer，如果缺失，请执行

php -r "copy('https://getcomposer.org.cn/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

安装

如果composer.json存在并且有包在需求列表中，请执行

composer install

否则，使用require指令添加或创建composer.json

composer require undostres-com-mx/superapp_sdk

更新

要更新此包，在composer.json文件夹中执行

composer update

用法

使用composer需要使用require_once('/vendor/autoload.php');

使用use UDT\SDK\SASDK;导入SDK

初始化静态类SASDK::init(hashKey, server);

在SASDK实例上可以执行

• encryptSDK($data) : (输入：数据数组，输出：字符串)

  • 使用3des算法加密字符串。

• decryptSDK($data, $decode) : (输入：字符串，输出：字符串或对象)

  • 使用3des算法解密字符串。

• decryptUDT($data) : (输入：字符串，输出：字符串)

  • 使用UDT算法解密字符串。

• validateRequestHeaders($apiKey, $apiToken) : (输入：接收到的API头部数据，输出：布尔值)

  • 检查api/token以查看请求是否验证。

• formatMoney($money) : (输入：字符串或数字，输出：符合udt标准的浮点数)

  • 给出标准的UDT货币格式，小数点分隔，不使用逗号。

• createPayment($json) : (输入：付款JSON（见Test.php），输出：对象)

  • 创建订单并检索付款URL。

• cancelOrder($paymentId) : (输入：要取消的付款id，输出：对象)

  • 在UDT上取消挂起的订单。

• refundOrder($paymentId, $transactionId, $value) : (输入：付款id，事务id和要退款的值，输出：对象)

  • 在UDT上退款已付款订单。

密钥工具

在项目根目录中执行以下操作以使用密钥工具

• 创建哈希密钥。
• 读取哈希密钥（由UDT提供）。
• 读取udt哈希（用户数据编码在url上）。

php .\Utils\KeyUtils.php

本地测试

为了进行测试调用，需要有一个ssl证书，为此请下载证书并更新您的php.ini，路径如下

[curl]
curl.cainfo="C:/php/ssl/cacert.pem"
openssl.cafile="C:/php/ssl/cacert.pem"

证书可以从这里下载。

在项目根目录中执行以下操作以打开测试工具

php .\Utils\Test.php

然后您可以成功调用。

请注意，要进行支付，您需要一个return和callback API。如果您不将其添加到请求中，支付将始终失败。

作者

• Carlos Miranda
• Adrian Garcia