web payments quickstart

Schnellstart für Web-Zahlungen

Schnellstart für die Verwendung des Web Payments SDK von Square

• Übersicht über das Web Payments SDK.
• API-Dokumentation.

Erste Schritte

Klonen Sie zunächst dieses Repository.

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

Installieren Sie Node.js, das npm enthält. Dieses Repository enthält eine .nvmrc Datei, wenn Sie nvm zum Verwalten Ihrer Knotenversionen verwenden.

Führen Sie dann Folgendes aus, um Abhängigkeiten zu installieren:

npm install

Führen Sie den Entwicklungsserver aus.

npm run dev

Öffnen Sie abschließend http://localhost:3000.

Anmeldeinformationen

Bevor Sie eine Zahlung entgegennehmen können, müssen Sie Ihre Entwickleranmeldeinformationen konfigurieren, die Sie im Entwickler-Dashboard finden.

Kopieren Sie .env.example nach .env.sandbox

cp .env.example .env.sandbox

Definieren Sie SQUARE_ACCESS_TOKEN mit Ihrem Sandbox- Zugriffstoken aus dem Entwickler-Dashboard.

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

Starten Sie Ihren Server neu, um diesen neuen Wert zu verwenden.

Denken Sie daran: Fügen Sie Ihre Zugriffstoken nicht zu Git hinzu!

Entwicklung

Aufstellen

Wenn Sie zu diesem Projekt beitragen, sollten Sie die in .nvmrc definierte Version von Node verwenden. Sie können nvm verwenden, um die richtige Version zu installieren:

nvm install $( cat .nvmrc )

Befolgen Sie die oben aufgeführten „Erste Schritte“, um Abhängigkeiten zu installieren und sicherzustellen, dass Ihr lokaler Server ordnungsgemäß startet.

Testen

Sie können alle Linters, Tests und Builds wie CI mit npm test ausführen.

Fusseln

Sie können alle Linters mit npm run lint ausführen.

ESLint

ESLint analysiert den Code, um Probleme zu finden und zu beheben. Wir verwenden eslint-plugin-square für die sofort einsatzbereite Konfiguration.

npm run lint:eslint

Warnungen und Fehler automatisch beheben

Mit der Option --fix kann ESLint manchmal Warnungen und Fehler automatisch für Sie beheben.

npm run lint:eslint --fix

Hübscher

Prettier ist ein eigensinniger Codeformatierer. Für diese Meinungen verwenden wir @square/prettier-config.

npm run lint:prettier

Beheben von Problemen mit dem Codestil

Wenn Sie nach dem Ausführen von npm run lint:prettier eine Warnung wie „Codestilprobleme in den oben genannten Dateien gefunden. Haben Sie vergessen, Prettier auszuführen?“ erhalten, können Sie diese von Prettier beheben lassen.

npm run lint:prettier:fix

Kontinuierliche Integration

GitHub Actions wird für unsere CI/CD-Workflows verwendet. Weitere Informationen finden Sie unter .github/workflows .

Lizenz

Copyright 2021 Square, Inc.

Lizenziert unter der Apache-Lizenz, Version 2.0 (die „Lizenz“); Sie dürfen diese Datei nur in Übereinstimmung mit der Lizenz verwenden. Eine Kopie der Lizenz erhalten Sie unter

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

Sofern nicht gesetzlich vorgeschrieben oder schriftlich vereinbart, wird die im Rahmen der Lizenz vertriebene Software „WIE BESEHEN“ und OHNE GEWÄHRLEISTUNGEN ODER BEDINGUNGEN JEGLICHER ART, weder ausdrücklich noch stillschweigend, vertrieben. Die spezifische Sprache, die die Berechtigungen und Einschränkungen im Rahmen der Lizenz regelt, finden Sie in der Lizenz.