/**
* 2016-09-08
* Конвертирует денежную величину из валюты платежа в учётную.
* @param float $amount
* @param O $o
* @return float
*/
public function cToBase($amount, O $o)
{
return df_currency_convert($amount, $this->currencyFromOQ($o), df_currency_base($o));
}
/**
* 2016-07-30
* @param string $name
* @param string|null|Phrase $label [optional]
* @param int|float|null $default [optional]
* @param array(string => mixed) $data [optional]
* @return Quantity|E
*/
protected function money($name, $label = null, $default = null, $data = [])
{
return $this->number($name, $label, $data + ['value' => $default, Number::LABEL_RIGHT => df_currency_base($this->scope())->getCode()]);
}
/**
* 2016-08-08
* @return float
*/
function df_currency_rate_to_current()
{
return df_currency_base()->getRate(df_currency_current());
}
/**
* 2016-09-08
* 2016-03-27
* «How is an online refunding implemented?» https://mage2.pro/t/959
* Сначала хотел cделать по аналогии с @see \Magento\Paypal\Model\Ipn::_registerPaymentRefund()
* https://github.com/magento/magento2/blob/9546277/app/code/Magento/Paypal/Model/Ipn.php#L467-L501
* Однако используемый там метод @see \Magento\Sales\Model\Order\Payment::registerRefundNotification()
* нерабочий: «Invalid method Magento\Sales\Model\Order\Creditmemo::register»
* https://mage2.pro/t/1029
* Поэтому делаю по аналогии с @see \Magento\Sales\Controller\Adminhtml\Order\Creditmemo\Save::execute()
*
* @param P $p
* @param I $i
* @param string|int|float|null $amount [optional]
* @return int
*/
function dfp_refund(P $p, I $i, $amount = null)
{
/** @var M $m */
$m = $p->getMethodInstance();
/** @var O $o */
$o = $m->o();
/** @var CML $cml */
$cml = df_o(CML::class);
$cml->setOrderId($o->getId());
$cml->setInvoiceId($i->getId());
if ($amount) {
/**
* 2016-09-08
* Обработка частичного возврата.
* Делаем по аналогии с @see \Dfe\TwoCheckout\Handler\RefundIssued::cm()
*
* Произвожу расчёты в базовой валюте, чтобы не мешали курсовые колебания,
* которые могли произойти в период между платежом и возвратом.
*/
/** @var float $refundAmountB */
$refundAmountB = $m->cToBase($m->amountParse($amount));
/** @var float $invoiceAmountB */
$invoiceAmountB = $i->getBaseGrandTotal();
/** @var float $diffB */
$diffB = $invoiceAmountB - $refundAmountB;
if (!df_is0($diffB)) {
/**
* 2016-05-23
* https://mage2.pro/tags/credit-memo-adjustment
*
* Стек вызова:
* 1) @used-by \Magento\Sales\Controller\Adminhtml\Order\CreditmemoLoader::load()
* https://github.com/magento/magento2/blob/b366da/app/code/Magento/Sales/Controller/Adminhtml/Order/CreditmemoLoader.php#L186
* 2) @used-by \Magento\Sales\Model\Order\CreditmemoFactory::createByInvoice()
* https://github.com/magento/magento2/blob/b366da/app/code/Magento/Sales/Model/Order/CreditmemoFactory.php#L155
* 3) @used-by \Magento\Sales\Model\Order\CreditmemoFactory::initData()
* https://github.com/magento/magento2/blob/b366da/app/code/Magento/Sales/Model/Order/CreditmemoFactory.php#L244-L246
*/
$cml->setCreditmemo(['adjustment_negative' => df_currency_convert($diffB, df_currency_base($o), $o->getOrderCurrency())]);
}
}
/** @var CM $cm */
$cm = $cml->load();
df_assert($cm);
/**
* 2016-03-28
* Важно! Иначе order загрузит payment автоматически вместо нашего,
* и флаг @see \Dfe\Stripe\Method::WEBHOOK_CASE будет утерян
*/
$cm->getOrder()->setData(O::PAYMENT, $p);
/** @var ICMS|CMS $cms */
$cms = df_om()->create(ICMS::class);
$cms->refund($cm, false);
/**
* 2016-03-28
* @todo Надо отослать покупателю письмо-оповещение о возврате оплаты.
* 2016-05-15
* Что интересно, при возврате из административной части Magento 2
* покупатель тоже не получает уведомление.
*/
return $cm->getId();
}
/**
* 2016-09-05
* @used-by \Df\Payment\FormElement\Currency::v()
* @param null|string|int|S|Store $store [optional]
* @param CurrencyM|string|null $orderCurrency [optional]
* @return array(string => CurrencyM|string|null)
*/
private static function map($store = null, $orderCurrency = null)
{
return dfcf(function ($store = null, $orderCurrency = null) {
return [self::$BASE => df_currency_base($store), self::$ORDER => $orderCurrency ?: df_currency_current($store)];
}, func_get_args());
}