Semua penyedia

Square

Pembeli membayar lewat akun Square Anda sendiri, dan Coin Moebius tidak pernah memegang uangnya. Mata uang checkout mengikuti lokasi Square Anda.

Apa yang Anda butuhkan

KolomApa yang dilakukannya
Access tokenMembiarkan kami memanggil Square untuk membuat tautan checkout. Rahasia.
Webhook signature keyMemastikan sebuah webhook benar-benar berasal dari Square. Rahasia.
Location IDLokasi Square yang menerima pembayaran. Menetapkan mata uangnya.
Success URL / Cancel URLTempat 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

  1. 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
  2. Beri nama aplikasi Anda

    Beri aplikasi nama yang mudah Anda kenali (misalnya "Coin Moebius"), lalu klik Next.

    Square → Name your application
  3. 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.

  4. 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
  5. 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
  6. Tambahkan subscription dan pilih event

    Beri nama (seperti "coin-moebius"). Di Notification URL, tempel alamat webhook Square toko 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 store id>
    Square → Add a webhook subscription

    ID toko Anda ada di halaman Pengaturan toko di dasbor Coin Moebius; masukkan ke alamat di atas. Event tambahan tidak berbahaya, kami mengabaikan yang tidak kami gunakan. Setelah Square terhubung, menu ⋯ kartunya memiliki Salin webhook URL untuk alamat yang sama.

  7. 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)
  8. 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
  9. Kembali di Coin Moebius: Hubungkan penyedia → Square

    Buka Penyedia di menu kiri dan klik Hubungkan penyedia. Ketik Square di kotak pencarian, atau gulir ke bawah sampai menemukannya, lalu klik. Formulir terbuka di Terhubung dengan Square, yang memasukkan Anda ke Square dan menyiapkan notifikasi pembayaran untuk Anda. Untuk menempelkan nilai dari panduan ini, beralihlah ke tab Masukkan kunci secara manual dan atur Success URL dan Cancel URL Anda. Di tab Nyata, tempel Access token, Webhook signature key, dan Location ID Anda, lalu klik Save. Menyiapkan dengan kredensial sandbox terlebih dahulu? Tempel di tab Tes, lalu tambahkan kredensial live nanti dari Ubah.

    Coin Moebius → Connect a provider → Square
  10. Anda sudah terhubung

    Square kini muncul di halaman Penyedia Anda. Menu ⋯-nya berisi Ubah, Salin webhook URL, dan Putuskan. Untuk menjalankan pesanan sandbox dari ujung ke ujung sebelum tayang, atur Lingkungan produk ke Tes.

    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:

  1. Buat sebuah produk dan atur Lingkungan-nya ke Tes. Itu menjalankan produknya pada kredensial sandbox Anda, jadi Anda bisa memesan penuh tanpa memindahkan uang. (Produk Tes hanya berjalan pada kredensial sandbox, jadi tambahkan dulu.)
  2. Taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke toko Anda.
  3. Selesaikan checkout dengan kartu uji sandbox dari atas.
  4. Buka Transaksi di toko Anda dan aktifkan Tampilkan transaksi uji. Sebuah baris baru muncul, bertanda Tes. Saat statusnya tertulis Lunas, 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. Rahasia yang tersimpan tetap tersembunyi. Untuk mengubahnya, pilih Ganti dan masukkan nilai baru.

Ada pertanyaan? Join our Discord

Siap menghubungkan penyedia?

Pilih penyedia yang sudah Anda pakai. Pembeli membayar lewat akun Anda, dan Anda tetap memakai satu tombol beli.