web payments quickstart

Panduan Memulai Pembayaran Web

Mulai cepat untuk menggunakan SDK Pembayaran Web Square

• Ikhtisar SDK Pembayaran Web.
• Dokumentasi API.

Memulai

Mulailah dengan mengkloning repositori ini.

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

Instal Node.js yang akan menyertakan npm . Repositori ini berisi file .nvmrc jika Anda menggunakan nvm untuk mengelola versi node Anda.

Kemudian, untuk menginstal dependensi, jalankan:

npm install

Jalankan server pengembangan.

npm run dev

Terakhir, buka http://localhost:3000.

Kredensial

Sebelum Anda dapat menerima pembayaran, Anda harus mengonfigurasi kredensial pengembang Anda yang dapat ditemukan di Dasbor Pengembang.

Salin .env.example ke .env.sandbox

cp .env.example .env.sandbox

Tentukan SQUARE_ACCESS_TOKEN dengan Token Akses Sandbox Anda dari Dasbor Pengembang.

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

Mulai ulang server Anda untuk menggunakan nilai baru ini.

Ingat: Jangan tambahkan token akses Anda ke git!

Perkembangan

Pengaturan

Saat berkontribusi pada proyek ini, Anda sebaiknya menggunakan versi Node seperti yang ditentukan oleh .nvmrc . Anda dapat menggunakan nvm untuk menginstal versi yang benar:

nvm install $( cat .nvmrc )

Ikuti petunjuk "Memulai" di atas untuk menginstal dependensi dan memverifikasi server lokal Anda dimulai dengan benar.

Pengujian

Anda dapat menjalankan semua linter, pengujian, dan build seperti CI dengan npm test .

Linting

Anda dapat menjalankan semua linter dengan npm run lint .

ESLint

ESLint menganalisis kode untuk menemukan dan memperbaiki masalah. Kami menggunakan eslint-plugin-square untuk konfigurasi out-of-the-box.

npm run lint:eslint

Memperbaiki peringatan dan kesalahan secara otomatis

ESLint terkadang dapat memperbaiki peringatan dan kesalahan secara otomatis untuk Anda dengan opsi --fix-nya.

npm run lint:eslint --fix

Lebih cantik

Prettier adalah pemformat kode yang berpendirian keras. Kami menggunakan @square/prettier-config untuk opini tersebut.

npm run lint:prettier

Memperbaiki masalah gaya kode

Jika setelah menjalankan npm run lint:prettier Anda mendapatkan peringatan seperti, "Masalah gaya kode ditemukan pada file di atas. Lupa menjalankan Prettier?", Anda dapat meminta Prettier memperbaikinya.

npm run lint:prettier:fix

Integrasi Berkelanjutan

Tindakan GitHub digunakan untuk alur kerja CI/CD kami. Lihat .github/workflows untuk detailnya.

Lisensi

Hak Cipta 2021 Square, Inc.

Berlisensi di bawah Lisensi Apache, Versi 2.0 ("Lisensi"); Anda tidak boleh menggunakan file ini kecuali sesuai dengan Lisensi. Anda dapat memperoleh salinan Lisensi di

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

Kecuali diwajibkan oleh undang-undang yang berlaku atau disetujui secara tertulis, perangkat lunak yang didistribusikan berdasarkan Lisensi didistribusikan berdasarkan DASAR "APA ADANYA", TANPA JAMINAN ATAU KETENTUAN DALAM BENTUK APAPUN, baik tersurat maupun tersirat. Lihat Lisensi untuk bahasa tertentu yang mengatur izin dan batasan berdasarkan Lisensi.