web payments quickstart

Краткое руководство по веб-платежам

Краткое руководство по использованию SDK Square Web Payments

• Обзор SDK веб-платежей.
• API-документация.

Начиная

Начните с клонирования этого репозитория.

git clone https://github.com/square/web-payments-quickstart
cd web-payments-quickstart

Установите Node.js, который будет включать npm . Этот репозиторий содержит файл .nvmrc , если вы используете nvm для управления версиями узлов.

Затем для установки зависимостей выполните:

npm install

Запустите сервер разработки.

npm run dev

Наконец, откройте http://localhost:3000.

Реквизиты для входа

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

Скопируйте .env.example в .env.sandbox

cp .env.example .env.sandbox

Определите SQUARE_ACCESS_TOKEN с помощью токена доступа к песочнице на панели управления разработчика.

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

Перезагрузите сервер, чтобы использовать это новое значение.

Помните: не добавляйте токены доступа в git!

Разработка

Настраивать

При содействии этому проекту вы захотите использовать версию Node, определенную в .nvmrc . Вы можете использовать nvm для установки правильной версии:

nvm install $( cat .nvmrc )

Следуйте приведенным выше инструкциям «Начало работы», чтобы установить зависимости и убедиться, что ваш локальный сервер запускается правильно.

Тестирование

Вы можете запускать все линтеры, тесты и сборки, такие как CI, с помощью npm test .

Линтинг

Вы можете запустить все линтеры с помощью npm run lint .

ESLint

ESLint анализирует код, чтобы найти и устранить проблемы. Мы используем eslint-plugin-square для готовой настройки.

npm run lint:eslint

Автоматическое исправление предупреждений и ошибок

ESLint иногда может автоматически исправлять предупреждения и ошибки с помощью опции --fix.

npm run lint:eslint --fix

красивее

Prettier — самоуверенный форматировщик кода. Для таких мнений мы используем @square/prettier-config.

npm run lint:prettier

Исправление проблем со стилем кода

Если после запуска npm run lint:prettier вы получите предупреждение типа: «В приведенных выше файлах обнаружены проблемы со стилем кода. Забыли запустить Prettier?», вы можете попросить Prettier их исправить.

npm run lint:prettier:fix

Непрерывная интеграция

GitHub Actions используется для наших рабочих процессов CI/CD. Подробности см. .github/workflows .

Лицензия

© Square, Inc., 2021 г.

Лицензия Apache версии 2.0 («Лицензия»); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу:

http://www.apache.org/licenses/LICENSE-2.0

Если это не требуется действующим законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, распространяется на условиях «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых. См. Лицензию для определения конкретного языка, регулирующего разрешения и ограничения в рамках Лицензии.