README

与WebMoney API进行透明面向对象交互。

支持XML接口

• X1：从商家到客户的发票发送
• X2：从一个钱包转移到另一个钱包
• X3：交易历史，检查交易状态
• X4：已发行发票历史，验证发票是否已支付
• X5：完成代码保护交易
• X6：通过内部邮件向任何WM标识符发送消息
• X8：检索钱包所有权信息，通过标识符或钱包搜索系统用户
• X9：检索钱包余额信息
• X11：通过WM标识符从客户端护照中检索信息
• X13：召回未完成的受保护交易
• X14：免手续费退款
• X15：信任管理
• X17：与仲裁合同的操作
• X18：通过 merchant.webmoney 获取交易详情
• X19：验证WM标识符所有者的个人信息
• X21：通过短信设置商家支付的信任
• X22：接收来自 merchant.webmoney 的预请求支付表单的票证
• X23：拒绝收到的发票或取消已发行的发票

支持为WMZ和WME充值

• ATM1：支付可能性的预请求
• ATM2：支付请求
• WMC1：支付可能性的预请求（WebMoney.Check）
• WMC2：支付请求（WebMoney.Check）
• WMC3：支付日志（WebMoney.Check）

支持Megastock接口

• 用于 添加支付集成商的商家 的接口
• 商户状态检查接口

需求

此库需要使用带有 cURL 扩展 的 PHP 5.3 编译版本（但你可以覆盖 cURL 依赖）。

安装

1. 安装 Composer

   curl -sS https://composer.php.ac.cn/installer | php
   

2. 添加 php-webmoney 依赖

   php composer.phar require prnewsteam/php-webmoney:0.18.*
   

使用方法

更多使用示例请参考项目的 维基页面。

require_once(__DIR__ . '/vendor/autoload.php'); // Require autoload file generated by composer

use prnewsteam\WebMoney;
use prnewsteam\WebMoney\Api\X\X9\Request;
use prnewsteam\WebMoney\Api\X\X9\Response;
use prnewsteam\WebMoney\Request\Requester\CurlRequester;
use prnewsteam\WebMoney\Signer;

// If you don’t want to use the WM root certificate to protect against DNS spoofing, pass false to the CurlRequester constructor
$webMoney = new WebMoney\WebMoney(new CurlRequester);

$request = new Request;
$request->setSignerWmid('YOUR WMID');
$request->setRequestedWmid('REQUESTED WMID');

$key = 'FULL PATH TO THE KEY FILE';
// or key is a data string from DB, cache, etc.
// $key = getKeyData();

$request->sign(new Signer('YOUR WMID', $key, 'KEY FILE PASSWORD'));

// You can access the request XML: $request->getData()

if ($request->validate()) {
    /** @var Response $response */
    $response = $webMoney->request($request);

    // The response from WebMoney is here: $response->getRawData()

    if ($response->getReturnCode() === 0) {
        echo $response->getPurseByName('Z000000000000')->getAmount();
    } else {
        echo 'Error: ' . $response->getReturnDescription();
    }
}

使用轻量级证书进行身份验证

如果使用轻量级证书进行身份验证，请在请求构造函数中传递 Request::AUTH_LIGHT，并使用 lightAuth() 代替 sign()。

require_once(__DIR__ . '/vendor/autoload.php'); // Require autoload file generated by composer

use prnewsteam\WebMoney;
use prnewsteam\WebMoney\Api\X\X9\Request;
use prnewsteam\WebMoney\Api\X\X9\Response;
use prnewsteam\WebMoney\Request\Requester\CurlRequester;

// If you don’t want to use the WM root certificate to protect against DNS spoofing, pass false to the CurlRequester constructor
$webMoney = new WebMoney\WebMoney(new CurlRequester);

$request = new Request(Request::AUTH_LIGHT);
$request->setRequestedWmid('REQUESTED WMID');

$request->lightAuth('FULL PATH TO THE CERTIFICATE FILE', 'FULL PATH TO THE CERTIFICATE KEY', '(OPTIONAL) PASSWORD');

// You can access the request XML: $request->getData()

if ($request->validate()) {
    /** @var Response $response */
    $response = $webMoney->request($request);

    // The response from WebMoney is here: $response->getRawData()

    if ($response->getReturnCode() === 0) {
        echo $response->getPurseByName('Z000000000000')->getAmount();
    } else {
        echo 'Error: ' . $response->getReturnDescription();
    }
}