wechatpay postman script

Платежный API WeChat Сценарий Postman v3

WeChat Payment APIv3 Сценарий предварительного запроса запроса почтальона (сценарий предварительного запроса).

Чтобы помочь разработчикам продавцов быстро приступить к работе, мы развертываем сценарий в облачной рабочей среде Postman WeChat Pay Public Workspace. Вам не нужно вручную импортировать скрипт, вам нужно всего лишь форкнуть коллекцию WeChat Payment APIv3 на свою рабочую среду, и вы сможете легко создавать и отправлять запросы WeChat Payment APIv3 в Postman.

Предварительные условия

• Postman — известная в отрасли платформа для создания и использования API. Рекомендуется зарегистрировать учетную запись, чтобы использовать ее различные функции.
• Станьте продавцом платежей WeChat.
• Закрытый ключ API продавца. Когда продавец подает заявку на получение сертификата API продавца, закрытый ключ продавца будет сгенерирован и сохранен в файле apiclient_key.pem в локальной папке сертификата.

быстрый старт

Шаг 1. Сценарий импорта вилки

Нажмите кнопку, чтобы войти в мастер, как показано ниже.

Нажмите Fork Collection , чтобы перейти к следующему шагу, заполните метку Fork Label и выберите целевую рабочую Workspace . В обычных обстоятельствах достаточно импортировать персональный рабочий стол My Workspace.

Нажмите Fork Collection чтобы завершить импорт. Вы можете увидеть «WeChat Payment APIv3» в назначенном вами рабочем пространстве.

Вы также можете импортировать сценарии локально.

Шаг 2. Настройка среды

Окружающая среда представляет собой набор переменных. Скрипт считывает переменные из среды и использует их для вычисления подписи запроса.

Вы можете создать пустую среду из шаблона параметров продавца, предоставленного «WeChat Payment APIv3», в свою собственную рабочую среду.

Затем найдите вновь созданную среду в разделе «Среды» на своем рабочем столе и нажмите Add a new varialbe чтобы добавить новую переменную:

• mchid : обязателен, номер продавца.
• merchant_serial_no : обязательный серийный номер сертификата API продавца.
• apiclient_key.pem : обязательный закрытый ключ API продавца в формате PEM.

ПредупреждениеВ целях безопасности внимательно прочтите меры предосторожности.

Ниже показан общий набор конфигураций.

Шаг 3: Отправьте запрос

Примечание. Для отправки запросов мы рекомендуем использовать настольное приложение Postman, которое работает быстрее и удобнее!

Теперь вернитесь в рабочую среду, войдите в коллекцию «WeChat Payment APIv3» и выберите запрос, который вы хотите отправить.

Затем заполните параметры запроса и измените параметры в теле в соответствии с комментариями.

Наконец, выберите среду, которую вы настроили ранее, и нажмите кнопку Send в правой части адресной строки, чтобы отправить запрос.

Принцип реализации

Pre-Request Script — это сценарий Javascript. Почтальон выполняет этот сценарий перед отправкой запроса. Скрипт делает следующее:

1. Загрузка зависимых библиотек
2. Прочтите переменные параметров продавца в среде.
3. Создайте строку подписи на основе запрошенного метода, URL-адреса, параметров, тела и другой информации и вычислите подпись запроса.
4. Установить заголовок запроса Authorization

Примечание. Дополнительные сведения о сценариях Postman см. в разделе Создание сценариев в Postman.

переменная параметра

имя переменной	Требуется ли это?	описывать	Примечание
мчид	да	Номер продавца
trader_serial_no	да	Серийный номер сертификата API-сертификата продавца
apiclient_key.pem	да	Закрытый ключ Merchant API в формате PEM
открытый идентификатор	нет	OpenID пользователя, {{openid}} в тестовом запросе.
аппид	нет	AppID паблик-аккаунта или мини-программы
Шанми	нет	Используйте подпись, содержащую коммерческую тайну, если значение true	Значение по умолчанию пусто, что означает использование подписи RSA.
pubkey.pem	Требуется при подписании государственной тайны	Открытый ключ Merchant API в формате PEM	Если закрытый ключ PEM содержит открытый ключ, эту переменную заполнять не нужно.
адрес_сервера	нет	Адрес сервера	По умолчанию используется https://api.mch.weixin.qq.com

Зависимые библиотеки

Скрипт использует напрямую:

• forge.min.js, PKI, RSA и ASN.1 для forge.
• sm2.js, подпись SM2 национальной секретной библиотеки TencentSM-javascript.

Чтобы избежать загрузки зависимых библиотек при каждом запросе, две библиотеки хранятся в переменных коллекции в качестве исходного кода. Это значительно сокращает время отправки запросов с помощью веб-версии Postman.

Меры предосторожности

Закрытые ключи Merchant API — очень конфиденциальная информация. При использовании этого кода следует учитывать следующие моменты:

• Установите для видимости рабочей области, настроенной с помощью закрытого ключа, значение Personal или Private и не устанавливайте для нее значение Public .
• Тип переменной закрытого ключа установлен как secret . Значения переменных отображаются на экране в виде маски.
• Значение переменной закрытого ключа устанавливается в Current Value . Current Value сохраняется только в локальном сеансе и не будет отправлено на сервер Postman.
• Если вы используете сценарий Postman, созданный кем-то другим, проверьте зависимые библиотеки, переменные и сценарии, чтобы убедиться, что они не были изменены во избежание внедрения небезопасного кода.

Примечание. Сведения о механизме безопасности Postman см. в разделе Безопасность Postman.

Как инициировать запрос о государственной тайне

Используйте шаблон параметра National Secret-Merchant и установите его в переменной среды:

• shangmi : Это true .
• mchid : обязателен, номер продавца.
• merchant_serial_no : обязательный серийный номер сертификата API продавца.
• apiclient_key.pem : обязательный закрытый ключ API продавца в формате PEM.
• pubkey.pem : обязательный национальный секретный открытый ключ API продавца в формате PEM.

Таким образом, сценарий будет использовать национальную тайну SM2 для вычисления подписи и отправки запроса национальной тайны.

локальный скрипт импорта

Примечание. Не рекомендуется импортировать сценарии локально. Это громоздко, подвержено ошибкам и не позволяет синхронизировать исходные изменения.

Для импорта Fork Collection требуется регистрация учетной записи Postman. Если вы не хотите регистрироваться, вы можете импортировать скрипт локально.

Сначала откройте коллекцию WeChatPay APIv3, разверните параметры и нажмите «Экспорт»:

Загрузите и сохраните файл wechatpay-apiv3.postman_collection.json локально. Затем есть два способа импортировать файл JSON локально:

• Кнопка Import в левом верхнем углу интерфейса Postman.
• Меню File > Import инициирует импорт.

Выберите локальный wechatpay-apiv3.postman_collection.json и нажмите «Подтвердить», чтобы завершить импорт.

Вы обнаружите, что в коллекции на рабочей среде добавлен новый набор запросов под названием «WeChatPay APIv3». После настройки среды вы можете отправить запрос.

Синхронизировать исходные изменения

Мы будем постепенно добавлять новые интерфейсы и обновлять существующие интерфейсы, но ветка коллекции, которую вы создаете в рабочей среде, не будет автоматически синхронизировать исходные изменения. Рекомендуется watch нашу общедоступную рабочую область, чтобы получать уведомления от почтальона при внесении изменений в исходную версию.

В это время вы можете использовать pull changes чтобы получить изменения восходящего потока.

Для внесения pull changes Postman может потребоваться некоторое время. Если у вас возникнут проблемы, повторный форк также будет хорошей идеей.

Часто задаваемые вопросы

При отправке запроса появляется сообщение об ошибке «Ошибка: слишком мало байтов для анализа DER» или «Слишком мало байтов для чтения значения ASN.1».

Обычно это вызвано неправильным заполнением переменной merchantPrivateKey настроенной в среде. Закрытый ключ, полученный сценарием, представляет собой строку, начинающуюся с -----BEGIN PRIVATEKEY----- и заканчивающуюся -----END PRIVATE KEY----- .

Почему мой запрос на отправку выполняется так медленно?

Если вы используете веб-версию Postman, используйте приложение Postman для настольного компьютера. Из-за ограничений совместного использования ресурсов между источниками (CORS) в браузерах запросы, отправленные веб-версией, пересылаются Postman в фоновом режиме.

Или используйте настольный агент Postman. Для получения дополнительной информации обратитесь к блогам, посвященным Postman.

Связаться с нами

Если у вас есть какие-либо вопросы, посетите наше сообщество разработчиков, чтобы получить обратную связь.

Мы также приветствуем любые проблемы и мерж-реквесты :-)