Использование документа Payment

Лицензии JetBrains OS

Разработка payment велась с использованием PhpStorm на основе бесплатных лицензий Open Source от JetBrains s.r.o., за что выражаем благодарность.

![Лицензия на программное обеспечение][ico-license] [![Последняя версия разработки][ico-version-dev]][link-packagist] [![Ежемесячные установки][ico-downloads-monthly]][link-downloads]

Старая версия документа: http://helei112g.github.io/payment

Новая версия документа следующая:

Количество наблюдателей со временем

![Количество наблюдателей со временем][starchart-cc]

Контакты и вознаграждения

Список вознаграждений

Пожалуйста, используйте пример кода при использовании, напрямую отправляйте issue при обнаружении ошибок; предоставляется платная техническая поддержка.

Содержание

• Объявление
  • [Важные уведомления](#Важные уведомления)
  • План
• Проблемы, решаемые с помощью Payment
• Как использовать
  • Установка
  • Интеграция проекта
  • Проектирование платёжной системы
  • Поддерживаемые интерфейсы
• Руководство по вкладу
  • Дизайн кода
  • Инструкции по подключению к платежам
• Документация третьих сторон
• Лицензия

Объявление

Некоторые важные обновления и информация о проекте, связанные с третьей стороной платежей.

Важные уведомления

1. 2019-04: Напоминание: сертификат CA WeChat был обновлён, пожалуйста, обновите проект до последней версии. После 29 мая оплата будет невозможна.

Официальное объявление: https://pay.weixin.qq.com/index.php/public/cms/content_detail?lang=zh&id=56602

План

1. С 28 марта 2019 года началась перестройка всего проекта, doing... ...

После перестройки проект несовместим с версией до 4.x, обратите внимание!

Проблемы, решаемые с помощью Payment

Цель Payment — упростить процесс чтения документации третьих сторон при интеграции с ними, а также часто возникающие проблемы. Payment разумно моделирует все интерфейсы третьих сторон и предоставляет унифицированный вход, позволяя пользователям сосредоточиться только на собственной бизнес-логике и дизайне платёжной системы.

В настоящее время интегрированы: Alipay, WeChat и большинство функций Taobao. Также приветствуются вклады от всех участников. Руководство по вкладам

Как использовать

Установка

Текущий проект Payment поддерживает только версию PHP > 7.0 и может быть установлен только через composer.

Необходимые расширения PHP:

- ext-curl
- ext-mbstring
- ext-bcmath
- package-Guzzle

Способ установки composer:

Непосредственно в командной строке:

composer require "riverslei/payment:*"

Через файл конфигурации проекта:

"require": {
    "riverslei/payment": "*"
}

Интеграция проекта

После завершения установки вы можете использовать его в своём проекте.

Для всего процесса предоставляется уникальный класс входа \Payment\Client, каждый канал представляет только демонстрацию APP оплаты и уведомления асинхронно/синхронно, как подключиться. Будет подробно объяснено, какие параметры поддерживаются каждым запросом.

Демонстрация APP оплаты

$config = [
    // Конфигурация, см. соответствующий подкаталог для шаблона конфигурации каждого канала
];

// Параметры запроса, полные параметры см. в соответствующей таблице
$payData = [
    'body'         => 'test body',
    'subject'      => 'test subject',
    'trade_no'     => 'trade no',// Реализовать самостоятельно
    'time_expire'  => time() + 600, // Указывает, что оплата должна быть произведена в течение 600 секунд
    'amount'       => '5.52', // Для режима песочницы WeChat требуется фиксированная сумма 3.01
    'return_param' => '123',
    'client_ip'    => isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : '127.0.0.1', // Адрес клиента
];``

// Использование
try {
    $client = new \Payment\Client(\Payment\Client::WECHAT, $wxConfig);
    $res    = $client->pay(\Payment\Client::WX_CHANNEL_APP, $payData);
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();
    exit;
} catch (\Payment\Exceptions\GatewayException $e) {
    echo $e->getMessage();
    var_dump($e->getRaw());
    exit;
} catch (\Payment\Exceptions\ClassNotFoundException $e) {
    echo $e->getMessage();
    exit;
} catch (Exception $e) {
    echo $e->getMessage();
    exit;
}

Асинхронные/синхронные уведомления

// Реализуйте свой собственный класс, наследуя этот интерфейс
class TestNotify implements \Payment\Contracts\IPayNotify
{
    /**
     * Обрабатывает собственную бизнес-логику, такую как обновление статуса транзакции, сохранение данных уведомлений и т. д.
     * @param string $channel Канал уведомления, такой как Alipay, WeChat, Taobao
     * @param string $notifyType Тип уведомления, например оплата, возврат
     * @param string $notifyWay Способ уведомления, например асинхронный async, синхронный sync
     * @param array $notifyData Данные уведомления
     * @return bool
     */
    public function handle(
        string $channel,
        string $notifyType,
        string $notifyWay,
        array $notifyData
    ) {
        //var_dump($channel, $notifyType, $notifyWay, $notifyData);exit;
        return true;
    }
}

$config = [
    // Конфигурация, см. соответствующий подкаталог для шаблона конфигурации каждого канала
];

// Экземпляр класса, унаследовавшего интерфейс
$callback = new TestNotify();

try {
    $client = new \Payment\Client(\Payment\Client::ALIPAY, $config);
    $xml = $client->notify($callback);
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();
    exit;
} catch (\Payment\Exceptions\GatewayException $e) {
    echo

*Примечание: В ответе могут быть неточности или ошибки перевода, так как некоторые фрагменты текста были не полностью понятны.* ```
$e->getMessage();
exit;
} catch (\Payment\Exceptions\ClassNotFoundException $e) {
    echo $e->getMessage();
    exit;
} catch (Exception $e) {
     echo $e->getMessage();
     exit;
 }

Из приведённого примера кода можно сделать вывод, что это язык PHP. Указанные данные представляют собой запрос на оплату с использованием различных платёжных каналов и возможностей.

В запросе присутствуют следующие параметры:

• trade_no — уникальный номер заказа, который присваивается продавцом;
• amount — сумма платежа в юанях с точностью до двух знаков после запятой;
• body — описание конкретной транзакции;
• subject — заголовок или ключевое слово для транзакции;
• time_expire — крайний срок оплаты;
• goods_detail — информация о товарах;
• return_params — общие параметры возврата;
• extend_params — расширенные параметры;
• goods_type — тип товара: 0 — виртуальный товар, 1 — физический товар;
• promo_params — параметры скидок (доступны только после согласования с платёжной системой);
• royalty_info — информация о распределении платежей;
• sub_merchant — информация об участвующем посреднике;
• store_id — идентификатор магазина;
• qr_pay_mode — режим оплаты с помощью QR-кода: 2 — предваряющий режим;
• qrcode_width — ширина QR-кода, задаётся продавцом;
• settle_info — сведения о расчётах;
• invoice_info — данные счёта;
• agreement_sign_params — параметры соглашения (используются при оплате по договору);
• integration_type — способ интеграции запроса;
• request_from_url — адрес источника запроса.

Это неполный список параметров. В запросе также присутствуют поля для запросов на возврат средств, отмену транзакции, закрытие сделки и перевод средств.

Для получения более точного перевода необходимо обратиться к специалисту в области IT. | Объяснение| Обязательно |---|---| subject | Краткое описание товара, это поле должно быть заполнено строго в соответствии со спецификацией. Подробнее см. Параметры спецификации | Да body | Поле для однотоварной скидки (в настоящее время не доступно) | Да trade_no | Номер заказа внутренней системы продавца, 32 символа, может содержать буквы. Дополнительные сведения см. в Номер заказа продавца| Да amount | Общая сумма заказа, единица измерения — юань | Да client_ip | Необходимо передать правильный IP-адрес пользователя, поддерживаются IPv4 и IPv6. Подробные инструкции см. в разделе Получение указания IP-адреса пользователя | Да device_info | Идентификатор устройства (идентификатор магазина или идентификатор платёжного терминала), обратите внимание: при оплате через веб-страницу или общедоступный аккаунт передаётся «WEB» | Нет return_param | Дополнительные данные, которые передаются без изменений в запросах API и платёжных уведомлениях. Это поле в основном используется для передачи пользовательских данных вместе с заказом | Нет time_expire | Время истечения срока действия заказа, временная метка | Нет goods_tag | Метка товара, параметры функции купонов или скидок, подробные сведения см. в Купоны или скидки | Нет scene_info | Это поле используется для отправки информации о платеже, подробности см. в документации WeChat | Нет

При использовании необходимо самостоятельно создать массив на основе вышеуказанных полей и передать его в соответствующий метод экземпляра \Payment\Client. Далее всё одинаково, повторяться не будем.

Параметры запроса счёта

Запрос на закрытие транзакции

Запрос на отмену транзакции

Запрос на возврат платежа

Запрос на запрос возврата платежа

Запрос счёта финансов

Платёжный запрос

Запрос оплаты на счёт мобильного телефона

Запроса оплаты на банковский счёт

Запрос платежа на счёт мобильного телефона / банковский счёт

Параметры запроса открытого ключа

Не требуются параметры, можно использовать напрямую

####Параметры запроса возврата платежа

####Параметры запроса заказа

####Параметры уже проведённого учёта

####Параметры поиска возврата платежа

####Параметры запроса счёта

Коммерческие предложения

• Платежи через приложение;
• H5 платежи;
• Платёж с помощью сканирования кода на ПК;
• Оплата с помощью QR-кода;
• Возврат средств;
• Запрос транзакции;
• Запрос возврата средств;
• Запроc протокола;
• Отмена протокола;
• Детализация зачисления средств;
• Загрузка формы возврата средств;
• Форма расчёта для продавца;
• Форма расчёта для банка;
• Скачивание детализации расчётов;
• Поиск открытого ключа банка.

Руководство по внесению вклада

Дизайн кода

Требуется доработка структуры всего кода.

Руководство по разработке

Необходимо дополнить информацию о том, как использовать новую функцию.

Документация третьих сторон

• Alipay (https://docs.open.alipay.com/api_1);
• WeChat (https://pay.weixin.qq.com/wiki/doc/api/index.html);
• CMB Bank (http://openhome.cmbchina.com/paynew/pay/Home).

Лицензия

Код для платёжной системы распространяется на условиях лицензии MIT (см. LICENSE).

[ico-license]: изображение иконки лицензии [ico-version-dev]: изображение иконки версии разработки [ico-downloads-monthly]: изображение иконки ежемесячных загрузок [link-packagist]: ссылка на Packagist [link-downloads]: ссылка на статистику загрузок Packagist [starchart-cc]: ссылка на Starchart