web payments quickstart

Démarrage rapide des paiements Web

Démarrage rapide pour l'utilisation du SDK Web Payments de Square

• Présentation du SDK de paiements Web.
• Documentation API.

Commencer

Commencez par cloner ce référentiel.

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

Installez Node.js qui inclura npm . Ce référentiel contient un fichier .nvmrc si vous utilisez nvm pour gérer vos versions de nœuds.

Ensuite, pour installer les dépendances, exécutez :

npm install

Exécutez le serveur de développement.

npm run dev

Enfin, ouvrez http://localhost:3000.

Informations d'identification

Avant de pouvoir accepter un paiement, vous devrez configurer vos informations d'identification de développeur qui se trouvent dans le tableau de bord du développeur.

Copiez .env.example dans .env.sandbox

cp .env.example .env.sandbox

Définissez SQUARE_ACCESS_TOKEN avec votre jeton d'accès Sandbox à partir du tableau de bord du développeur.

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

Redémarrez votre serveur pour utiliser cette nouvelle valeur.

N'oubliez pas : n'ajoutez pas vos jetons d'accès à git !

Développement

Installation

Lorsque vous contribuez à ce projet, vous souhaiterez utiliser la version de Node telle que définie par .nvmrc . Vous pouvez utiliser nvm pour installer la bonne version :

nvm install $( cat .nvmrc )

Suivez les instructions « Mise en route » ci-dessus pour installer les dépendances et vérifier que votre serveur local démarre correctement.

Essai

Vous pouvez exécuter tous les linters, tests et builds comme CI avec npm test .

Pelucheux

Vous pouvez exécuter tous les linters avec npm run lint .

ESLint

ESLint analyse le code pour rechercher et résoudre les problèmes. Nous utilisons eslint-plugin-square pour une configuration prête à l'emploi.

npm run lint:eslint

Correction automatique des avertissements et des erreurs

ESLint peut parfois corriger automatiquement les avertissements et les erreurs pour vous grâce à son option --fix.

npm run lint:eslint --fix

Plus jolie

Prettier est un formateur de code avisé. Nous utilisons @square/prettier-config pour ces opinions.

npm run lint:prettier

Résolution des problèmes de style de code

Si après avoir exécuté npm run lint:prettier vous recevez un avertissement du type : "Problèmes de style de code trouvés dans le(s) fichier(s) ci-dessus. Vous avez oublié d'exécuter Prettier ?", vous pouvez demander à Prettier de les résoudre.

npm run lint:prettier:fix

Intégration continue

GitHub Actions est utilisé pour nos workflows CI/CD. Voir .github/workflows pour plus de détails.

Licence

Copyright 2021 Square, Inc.

Sous licence Apache, version 2.0 (la « Licence » ); vous ne pouvez pas utiliser ce fichier sauf en conformité avec la licence. Vous pouvez obtenir une copie de la licence à

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

Sauf disposition contraire de la loi applicable ou accord écrit, le logiciel distribué sous la licence est distribué « TEL QUEL », SANS GARANTIE OU CONDITION D'AUCUNE SORTE, expresse ou implicite. Consultez la licence pour connaître la langue spécifique régissant les autorisations et les limitations en vertu de la licence.