Initial Commit

This commit is contained in:
2024-02-08 12:07:49 -07:00
parent 5813b1109f
commit 43077b57ed
5471 changed files with 682195 additions and 0 deletions
@@ -0,0 +1,83 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Common\AbstractObject;
use YooKassa\Common\Exceptions\EmptyPropertyValueException;
use YooKassa\Common\Exceptions\InvalidPropertyValueException;
use YooKassa\Common\Exceptions\InvalidPropertyValueTypeException;
use YooKassa\Helpers\TypeCast;
use YooKassa\Model\ConfirmationType;
/**
* Способ подтверждения платежа.
*
* @property-read string $type
*
* @method getConfirmationUrl
* @method getConfirmationToken
* @method getConfirmationData
*/
abstract class AbstractConfirmation extends AbstractObject
{
/**
* @var string
*/
private $_type;
/**
* @return string
*/
public function getType()
{
return $this->_type;
}
/**
* @param string $value
*/
protected function _setType($value)
{
if ($value === null || $value === '') {
throw new EmptyPropertyValueException(
'Empty value for "type" parameter in Confirmation', 0, 'confirmation.type'
);
} elseif (TypeCast::canCastToEnumString($value)) {
if (ConfirmationType::valueExists($value)) {
$this->_type = (string)$value;
} else {
throw new InvalidPropertyValueException(
'Invalid value for "type" parameter in Confirmation', 0, 'confirmation.type', $value
);
}
} else {
throw new InvalidPropertyValueTypeException(
'Invalid value type for "type" parameter in Confirmation', 0, 'confirmation.type', $value
);
}
}
}
@@ -0,0 +1,42 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Model\ConfirmationType;
/**
* Сценарий при котором необходимо получить одноразовый код от плательщика для подтверждения платежа
*
* @package YooKassa\Model\Confirmation
*/
class ConfirmationCodeVerification extends AbstractConfirmation
{
public function __construct()
{
$this->_setType(ConfirmationType::CODE_VERIFICATION);
}
}
@@ -0,0 +1,42 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Model\ConfirmationType;
/**
* Сценарий при котором необходимо направить плательщика в приложение партнера
*
* @package YooKassa\Model\Confirmation
*/
class ConfirmationDeepLink extends AbstractConfirmation
{
public function __construct()
{
$this->_setType(ConfirmationType::DEEPLINK);
}
}
@@ -0,0 +1,68 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Common\Exceptions\InvalidPropertyValueTypeException;
use YooKassa\Helpers\TypeCast;
use YooKassa\Model\ConfirmationType;
/**
* @property string $confirmationToken Токен для checkout.js
*/
class ConfirmationEmbedded extends AbstractConfirmation
{
private $confirmationToken;
public function __construct()
{
$this->_setType(ConfirmationType::EMBEDDED);
}
/**
* @return string
*/
public function getConfirmationToken()
{
return $this->confirmationToken;
}
/**
* @param string $confirmationToken
*/
public function setConfirmationToken($confirmationToken)
{
if ($confirmationToken === null || $confirmationToken === '') {
$this->confirmationToken = null;
} elseif (TypeCast::canCastToString($confirmationToken)) {
$this->confirmationToken = (string)$confirmationToken;
} else {
throw new InvalidPropertyValueTypeException(
'Invalid confirmationToken value type', 0, 'confirmationEmbedded.confirmationToken', $confirmationToken
);
}
}
}
@@ -0,0 +1,43 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Model\ConfirmationType;
/**
* Сценарий при котором необходимо ожидать пока пользователь самостоятельно подтвердит платеж. Например,
* пользователь подтверждает платеж ответом на SMS или в приложении партнера
*
* @package YooKassa\Model\Confirmation
*/
class ConfirmationExternal extends AbstractConfirmation
{
public function __construct()
{
$this->_setType(ConfirmationType::EXTERNAL);
}
}
@@ -0,0 +1,92 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Model\ConfirmationType;
/**
* Class ConfirmationFactory
*
* @package YooKassa\Model\Confirmation
*/
class ConfirmationFactory
{
private $typeClassMap = array(
ConfirmationType::CODE_VERIFICATION => 'ConfirmationCodeVerification',
ConfirmationType::DEEPLINK => 'ConfirmationDeepLink',
ConfirmationType::EXTERNAL => 'ConfirmationExternal',
ConfirmationType::REDIRECT => 'ConfirmationRedirect',
ConfirmationType::EMBEDDED => 'ConfirmationEmbedded',
ConfirmationType::QR => 'ConfirmationQr',
);
/**
* @param string $type
*
* @return AbstractConfirmation
*/
public function factory($type)
{
if (!is_string($type)) {
throw new \InvalidArgumentException('Invalid confirmation value in confirmation factory');
}
if (!array_key_exists($type, $this->typeClassMap)) {
throw new \InvalidArgumentException('Invalid confirmation value type "'.$type.'"');
}
$className = __NAMESPACE__.'\\'.$this->typeClassMap[$type];
return new $className();
}
/**
* @param array $data
* @param string|null $type
*
* @return AbstractConfirmation
*/
public function factoryFromArray(array $data, $type = null)
{
if ($type === null) {
if (array_key_exists('type', $data)) {
$type = $data['type'];
unset($data['type']);
} else {
throw new \InvalidArgumentException(
'Parameter type not specified in ConfirmationFactory.factoryFromArray()'
);
}
}
$confirmation = $this->factory($type);
foreach ($data as $key => $value) {
if ($confirmation->offsetExists($key)) {
$confirmation->offsetSet($key, $value);
}
}
return $confirmation;
}
}
@@ -0,0 +1,69 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Common\Exceptions\InvalidPropertyValueTypeException;
use YooKassa\Helpers\TypeCast;
use YooKassa\Model\ConfirmationType;
/**
* @property string $confirmationData URL для создания QR-кода
* @property string $confirmation_data URL для создания QR-кода
*/
class ConfirmationQr extends AbstractConfirmation
{
private $_confirmationData;
public function __construct()
{
$this->_setType(ConfirmationType::QR);
}
/**
* @return string
*/
public function getConfirmationData()
{
return $this->_confirmationData;
}
/**
* @param string $confirmationData
*/
public function setConfirmationData($confirmationData)
{
if ($confirmationData === null || $confirmationData === '') {
$this->_confirmationData = null;
} elseif (TypeCast::canCastToString($confirmationData)) {
$this->_confirmationData = (string)$confirmationData;
} else {
throw new InvalidPropertyValueTypeException(
'Invalid confirmationData value type', 0, 'confirmationQr.confirmationData', $confirmationData
);
}
}
}
@@ -0,0 +1,143 @@
<?php
/**
* The MIT License
*
* Copyright (c) 2020 "YooMoney", NBСO LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
namespace YooKassa\Model\Confirmation;
use YooKassa\Common\Exceptions\InvalidPropertyValueTypeException;
use YooKassa\Helpers\TypeCast;
use YooKassa\Model\ConfirmationType;
/**
* Сценарий, при котором необходимо отправить плательщика на веб-страницу ЮKassa или партнера для
* подтверждения платежа
*
* @property bool $enforce Требование принудительного подтверждения платежа покупателем, требование 3-D Secure для
* оплаты банковскими картами. По умолчанию определяется политикой платежной системы.
* @property string $returnUrl URL на который вернется плательщик после подтверждения или отмены платежа на
* странице партнера.
* @property string $return_url URL на который вернется плательщик после подтверждения или отмены платежа на
* странице партнера.
* @property string $confirmationUrl URL на который необходимо перенаправить плательщика для подтверждения оплаты.
* @property string $confirmation_url URL на который необходимо перенаправить плательщика для подтверждения оплаты.
*/
class ConfirmationRedirect extends AbstractConfirmation
{
/**
* @var bool Требование принудительного подтверждения платежа покупателем, требование 3-D Secure для оплаты
* банковскими картами. По умолчанию определяется политикой платежной системы.
*/
private $_enforce;
/**
* @var string URL на который вернется плательщик после подтверждения или отмены платежа на странице партнера.
*/
private $_returnUrl;
/**
* @var string URL на который необходимо перенаправить плательщика для подтверждения оплаты.
*/
private $_confirmationUrl;
public function __construct()
{
$this->_setType(ConfirmationType::REDIRECT);
}
/**
* @return bool Требование принудительного подтверждения платежа покупателем, требование 3-D Secure для
* оплаты банковскими картами. По умолчанию определяется политикой платежной системы.
*/
public function getEnforce()
{
return $this->_enforce;
}
/**
* @param bool $value Требование принудительного подтверждения платежа покупателем, требование 3-D Secure
* для оплаты банковскими картами. По умолчанию определяется политикой платежной системы.
*/
public function setEnforce($value)
{
if ($value === null || $value === '') {
$this->_enforce = null;
} elseif (TypeCast::canCastToBoolean($value)) {
$this->_enforce = (bool)$value;
} else {
throw new InvalidPropertyValueTypeException(
'Invalid enforce value type', 0, 'confirmationRedirect.enforce', $value
);
}
}
/**
* @return string URL на который вернется плательщик после подтверждения или отмены платежа на странице партнера.
*/
public function getReturnUrl()
{
return $this->_returnUrl;
}
/**
* @param string $value URL на который вернется плательщик после подтверждения или отмены платежа на
* странице партнера.
*/
public function setReturnUrl($value)
{
if ($value === null || $value === '') {
$this->_returnUrl = null;
} elseif (TypeCast::canCastToString($value)) {
$this->_returnUrl = (string)$value;
} else {
throw new InvalidPropertyValueTypeException(
'Invalid returnUrl value type', 0, 'confirmationRedirect.returnUrl', $value
);
}
}
/**
* @return string URL на который необходимо перенаправить плательщика для подтверждения оплаты.
*/
public function getConfirmationUrl()
{
return $this->_confirmationUrl;
}
/**
* @param string $value URL на который необходимо перенаправить плательщика для подтверждения оплаты.
*/
public function setConfirmationUrl($value)
{
if ($value === null || $value === '') {
$this->_confirmationUrl = null;
} elseif (TypeCast::canCastToString($value)) {
$this->_confirmationUrl = (string)$value;
} else {
throw new InvalidPropertyValueTypeException(
'Invalid confirmationUrl value type', 0, 'confirmationRedirect.confirmationUrl', $value
);
}
}
}