การเริ่มต้นอย่างรวดเร็วสำหรับการใช้ Web Payments SDK ของ Square
เริ่มต้นด้วยการโคลนที่เก็บนี้
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
ด้วยโทเค็นการเข้าถึง Sandbox ของคุณจากแดชบอร์ดสำหรับนักพัฒนา
SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n
รีสตาร์ทเซิร์ฟเวอร์ของคุณเพื่อใช้ค่าใหม่นี้
ข้อควรจำ: อย่าเพิ่มโทเค็นการเข้าถึงของคุณเพื่อคอมไพล์!
เมื่อมีส่วนร่วมในโปรเจ็กต์นี้ คุณจะต้องใช้เวอร์ชันของ Node ตามที่กำหนดโดย .nvmrc
คุณสามารถใช้ nvm เพื่อติดตั้งเวอร์ชันที่ถูกต้อง:
nvm install $( cat .nvmrc )
ปฏิบัติตามคำแนะนำ "เริ่มต้นใช้งาน" ด้านบนเพื่อติดตั้งการขึ้นต่อกันและตรวจสอบว่าเซิร์ฟเวอร์ภายในของคุณเริ่มทำงานอย่างถูกต้อง
คุณสามารถรัน linters การทดสอบ และบิลด์ทั้งหมด เช่น CI ด้วย npm test
คุณสามารถเรียกใช้ linters ทั้งหมดด้วย npm run lint
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
สำหรับรายละเอียด
ลิขสิทธิ์ 2021 Square, Inc.
ได้รับอนุญาตภายใต้ Apache License เวอร์ชัน 2.0 ("ใบอนุญาต"); คุณไม่สามารถใช้ไฟล์นี้ได้เว้นแต่จะเป็นไปตามใบอนุญาต คุณสามารถขอรับสำเนาใบอนุญาตได้ที่
http://www.apache.org/licenses/LICENSE-2.0
เว้นแต่กฎหมายที่ใช้บังคับกำหนดหรือตกลงเป็นลายลักษณ์อักษร ซอฟต์แวร์ที่เผยแพร่ภายใต้ใบอนุญาตนี้จะถูกแจกจ่าย "ตามที่เป็น" โดยไม่มีการรับประกันหรือเงื่อนไขใดๆ ทั้งโดยชัดแจ้งหรือโดยนัย ดูใบอนุญาตสำหรับภาษาเฉพาะที่ควบคุมการอนุญาตและข้อจำกัดภายใต้ใบอนุญาต