wechatpay-v3-api

Описание

Пакет с веб-интерфейсами версии v3 для мерчантов WeChat.

Для тестирования обратитесь к инструкциям по тестированию.

Обязательно следует придерживаться следующих правил при разработке и тестировании:

• Запрещено использовать в коде src и юнит-тестах жёстко закодированные данные, такие как ID мерчанта, SerialNo, PrivateKey (в виде текста, знаю, что многие программисты так делают).
• Запрещено использовать в коде src и юнит-тестах открытые данные, такие как ID купона, ticket и т.д.
• Тестовые данные обязательно должны храниться в защищённых директориях (protected или private) (уже добавлены в .gitignore). Данные должны храниться в файлах и придерживаться следующих правил:
  • При добавлении нового файла с данными в директорию protected, обязательно добавьте соответствующий файл в директорию example.protected.
  • При каждом изменении или удалении данных в файлах директории protected, также выполните соответствующие действия в директории example.protected.
  • Перед каждым коммитом очистите все данные в директории example.protected.

Не требуется обязательное использование комментариев и документации, но каждый обёрнутый интерфейс обязательно должен содержать ссылку на соответствующую документацию WeChat Pay, формат: // @see url...

Реализованные функции и интерфейсы

Общие характеристики

• Валидация запросов для интерфейсов v3
• Разделение ответов на успешные и неудачные, а также извлечение данных

Интерфейсы

Купоны (VoucherApi)

• Получение всех активных купонов мерчанта (getVouchers)
• Получение конкретного купона мерчанта по stockId (getVoucher)
• Выпуск купона (giveVoucher)
  • Уведомление: этот интерфейс предназначен только для выпуска купона, а не для его помещения в кошелёк пользователя.
  • API для помещения купона в кошелёк пользователя реализован на странице H5 (необходимо подтвердить конкретные вызовы).
• Получение всех доступных купонов пользователя для определенного мерчанта (getUserVouchers)
• Получение деталей конкретного купона пользователя по couponId (getUserVoucher)
• Получение списка доступных мерчантов для купона по stockId (getVoucherMerchants)

Интерфейсы версии V2

Подпись

$api = PayV3Api::getInstance($name);
$api->init($merchantId, $serialNo, $privateKeyFile);

$data = []; // данные для подписи
$appId = ''; // AppId WeChat Official Account
$res = $api->getMpSendCouponSign($appId, $data);

Список задач

• Валидация заголовков ответа и статуса HTTP Основные правила интерфейса Подтверждение подписи