README

Moka API PHP 客户端提供从用 PHP 编写的应用程序中方便地访问 Moka API 的方法。

要求

PHP 5.6.0 及更高版本。

Composer

您可以通过 Composer 安装绑定。运行以下命令

composer require moka/moka-php

要使用绑定，使用 Composer 的自动加载

require_once('vendor/autoload.php');

手动安装

如果您不希望使用 Composer，您可以下载最新的发布版。然后，要使用绑定，包括 autoload.php 文件。

require_once('autoload.php');

依赖项

绑定需要以下扩展才能正常工作

如果您使用 Composer，这些依赖项应该会自动处理。如果您手动安装，请确保这些扩展可用。

SSL / TLS

PCI-DSS 规则仅允许使用 TLS 1.2 及以上协议。请确保您的应用程序通过这些协议向 Moka URL 发送 POST 请求。否则，您将收到类似于“连接将被关闭”或“连接已关闭”的错误。

入门指南

简单使用如下

$moka = new \Moka\MokaClient([
    'dealerCode' => 'xxx',
    'username' => 'xxx',
    'password' => 'xxx',    
]);

默认情况下，PHP 客户端连接到实时环境 URL：https://service.moka.com 为了测试目的，请使用测试环境 URL：https://service.refmoka.com

$moka = new \Moka\MokaClient([
    'dealerCode' => 'xxx',
    'username' => 'xxx',
    'password' => 'xxx',    
    'baseUrl' => 'https://service.refmoka.com'
]);

创建支付

$moka = new \Moka\MokaClient([
    'dealerCode' => 'xxx',
    'username' => 'xxx',
    'password' => 'xxx',    
]);

$request = new Moka\Model\CreatePaymentRequest();

$request->setCardHolderFullName('John Doe');
$request->setCardNumber('5555666677778888');
$request->setExpMonth('09');
$request->setExpYear('2024');
$request->setCvcNumber('123');
$request->setAmount(0.01);
$request->setCurrency('TL');
$request->setInstallmentNumber(1);
$request->setClientIp('192.168.1.116');
$request->setOtherTrxCode('3D5ABC24-456"');
$request->setIsPoolPayment(0);
$request->setIsTokenized(0);
$request->setIntegratorId(0);
$request->setSoftware('Software');
$request->setDescription('');
$request->setIsPreAuth(0);

$buyer = new Moka\Model\Buyer();
$buyer->setBuyerFullName('John Doe');
$buyer->setBuyerGsmNumber('5551110022');
$buyer->setBuyerEmail('email@email.com');
$buyer->setBuyerAddress('Levent Mah. Meltem Sok. İş Kuleleri Kule 2 No: 10 / 4 Beşiktaş / İstanbul');

$request->setBuyerInformation($buyer);

$payment = $moka->payments()->create($request);

$payment->getData();
$payment->getResultCode();
$payment->getResultMessage();
$payment->getException();

文档

请参阅Moka API 文档。

测试卡

请参阅测试卡。

moka / moka-php

维护者

详细信息