Apa yang Anda butuhkan
| Kolom | Apa yang dilakukannya |
|---|---|
| Access token | Membiarkan kami memanggil Square untuk membuat tautan checkout. Rahasia. |
| Webhook signature key | Memastikan sebuah webhook benar-benar berasal dari Square. Rahasia. |
| Location ID | Lokasi Square yang menerima pembayaran. Menetapkan mata uangnya. |
| Success URL / Cancel URL | Tempat pembeli mendarat setelah membayar atau mundur. |
Kenapa kami meminta setiap kolom
Access token
Mengotorisasi pembuatan tautan checkout, agar tagihannya berjalan lewat akun Anda.
Webhook signature key
Membuktikan webhook masuk benar-benar dari Square, jadi tidak ada yang bisa memalsukan event "paid". Ia adalah nilai terpisah dari access token.
Location ID
Memberi tahu Square lokasi mana yang menerima uangnya, dan menetapkan mata uang checkout. Bukan rahasia.
Success and Cancel URL
Pengaturan biasa: tempat pembeli mendarat setelah membayar atau mundur. Bukan rahasia.
Penyiapan
- Buka dasbor Square Developer
Masuk di developer.squareup.com. Setiap aplikasi memiliki kredensialnya sendiri, dan Sandbox gratis dibuat bersama aplikasi tersebut untuk pengujian. Panduan ini menggunakan Sandbox; alur Live identik, cukup balik toggle Sandbox / Production dan gunakan kredensial produksi Anda. Untuk membuat aplikasi baru, klik tile + di layar Applications.
Square Developer → Applications - Beri nama aplikasi Anda
Beri aplikasi nama yang mudah Anda kenali (misalnya "Coin Moebius"), lalu klik Next.
Square → Name your application - Salin access token Anda
Buka aplikasi dan buka Credentials. Pastikan toggle Sandbox / Production di bagian atas sesuai dengan lingkungan yang sedang Anda siapkan. Klik ikon salin di sebelah Access token dan simpan.
Square → Credentials Access token bersifat rahasia, perlakukan seperti kata sandi. Sandbox dan Production memiliki token terpisah, jadi jangan mencampurnya.
- Salin Location ID Anda
Di menu kiri, buka Locations. Salin Location ID dari lokasi yang seharusnya menerima pembayaran. Lokasi tersebut menentukan mata uang checkout, jadi pilih yang mata uangnya ingin Anda tagihkan.
Square → Locations - Buka Webhooks → Subscriptions
Square menyebut endpoint webhook sebagai "subscription." Di menu kiri, luaskan Webhooks, buka Subscriptions, dan klik Add subscription.
Square → Webhooks → Subscriptions → Add subscription - Tambahkan subscription dan pilih event
Beri nama (seperti "coin-moebius"). Di Notification URL, tempel alamat webhook Square proyek Anda (di bawah). Kemudian, di bawah Events, cari dan centang event yang didengarkan Coin Moebius, lalu klik Save.
- Pembayaran sekali bayar: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated.
- Langganan (hanya jika Anda menjualnya): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed. Jika Anda tidak menagih secara berulang, lewati ini.
https://api.coinmoebius.com/webhook/square/<your project id>Square → Add a webhook subscription ID proyek Anda ada di bawah nama proyek di dasbor Coin Moebius; masukkan ke alamat di atas. Event tambahan tidak berbahaya, kami mengabaikan yang tidak kami gunakan. Kartu penyedia yang terhubung (langkah terakhir) menampilkan URL yang sama sebagai referensi.
- Buka subscription yang baru saja Anda buat
Square menyimpan subscription dan mencantumkannya di bawah Webhooks dengan status Enabled. Klik namanya untuk membuka panel detail tempat signing key berada.
Square → Webhooks → subscription Anda (Enabled) - Salin Signature key
Di panel Properties subscription, klik ikon salin di sebelah Signature key. Ini adalah nilai yang digunakan Coin Moebius untuk memastikan setiap webhook benar-benar berasal dari Square. Nilai ini hanya ada setelah subscription dibuat, itulah mengapa langkah webhook mendahului langkah connect.
Square → subscription Anda → Signature key - Kembali di Coin Moebius: Add provider → Square
Di proyek Anda, buka tab Providers, klik Add provider, pilih Connect a service, dan pilih Square. Atur Success URL dan Cancel URL Anda. Di tab Live, tempel Access token, Webhook signature key, dan Location ID Anda, lalu klik Save. Menyiapkan dengan kredensial sandbox terlebih dahulu? Tempel di tab Test, lalu tambahkan kredensial live nanti dari Edit.
Coin Moebius → Add provider → Square - Anda sudah terhubung
Square kini muncul di tab Providers Anda beserta tanggal koneksinya. Kartu menampilkan URL webhook yang sama yang Anda tempel ke Square, plus Edit dan Disconnect. Gunakan toggle Test mode untuk menjalankan pesanan sandbox dari ujung ke ujung sebelum tayang.
Coin Moebius → Providers → Square (terhubung) Kartu Sandbox tidak pernah menagih kartu sungguhan. Gunakan kartu 4111 1111 1111 1111, CVV 111, kedaluwarsa masa depan apa pun, kode pos valid apa pun (misalnya 94103).
Setelah Anda menghubungkan
Jalankan satu pembayaran uji sebelum tayang:
- Buat sebuah produk dan atur Environment-nya ke Testing. Itu menjalankan produknya pada kredensial sandbox Anda, jadi Anda bisa memesan penuh tanpa memindahkan uang. (Jika Anda melewatkan set sandbox, produk Testing kembali ke live, jadi tambahkan dulu.)
- Taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
- Selesaikan checkout dengan kartu uji sandbox dari atas.
- Buka tab Transaksi. Sebuah baris baru muncul, bertanda Testing. Saat statusnya mencapai succeeded, kredensial dan webhook Anda keduanya berfungsi dari ujung ke ujung.
Alihkan Environment produk ke Live saat Anda siap untuk pembayaran sungguhan.
Pemecahan masalah
Mulai dengan Verify. Di dasbor, klik Verify (atau Verify test credentials) untuk memeriksa access token dan lokasi Anda.
Verify gagal.
Salin ulang access token dan Location ID. Production dan Sandbox punya token terpisah, jadi jangan mencampurnya.
Verifikasi tanda tangan gagal, atau pesanan tetap pending.
Square menandatangani notification URL persis ditambah body-nya. URL yang Anda daftarkan di Square harus cocok dengan URL webhook Anda karakter demi karakter, tanpa garis miring di akhir dan tanpa query string tambahan. Lalu salin ulang signature key dari endpoint yang sama itu.
Pastikan dari ujung ke ujung.
Konsol Developer Square → Webhooks → langganan Anda → Send Test Event, lalu amati pesanannya diperbarui.
Baik untuk diketahui
Mata uang mengikuti lokasi. Checkout menagih dalam mata uang lokasi yang id-nya Anda berikan.
Memutar secret. Putar access token atau signature key kapan saja, lalu tempel nilai barunya. Kolom rahasia tetap kosong saat diedit.
Ada pertanyaan? Join our Discord