Menggunakan pembayaran multirantai
Cara lengkap memakai layanan penerimaan pembayaran:
- Dua jalur integrasi: checkout (atur lalu kirim tautan, tanpa kode) serta aplikasi + API (sistem Anda membuat pesanan dan menerima notifikasi)
- Dua model kustodi: dana di alamat kustodi platform dapat ditarik setelah dikumpulkan, dengan biaya dipotong saat pengumpulan; dana di alamat kelola mandiri langsung masuk ke alamat Anda, dengan biaya setiap transaksi dipotong dari saldo akun
- Konfigurasi aplikasi: App Key untuk tanda tangan pemesanan, rahasia pengiriman untuk verifikasi tanda tangan notifikasi, URL callback wajib https, serta pilihan penerimaan bergilir atau 1-ke-1
- Notifikasi dianggap terkirim saat server mengembalikan 2xx; jika gagal, notifikasi dicoba ulang otomatis hingga 10 kali, dan dapat dikirim ulang dari log notifikasi
- Halaman dana: kumpulan alamat, aset, konfigurasi pengumpulan, penarikan dan transfer dana, transaksi, serta penarikan API
- Presisi token dan offset penerimaan menentukan digit akhir jumlah yang harus dibayar; beberapa pesanan pada satu alamat dibedakan dengan digit akhir ini, sehingga jumlah harus dibayar tepat
Fungsi layanan ini
Pembayaran multirantai adalah layanan inti platform: pelanggan membayar dengan kripto seperti USDT, dan dana masuk ke alamat penerimaan atas nama Anda. Ada dua jalur integrasi; Anda dapat memakai salah satunya saja atau keduanya sekaligus.
- Checkout: platform membuat tautan pembayaran dan QR khusus. Atur merek serta parameter dan kirim ke pelanggan — tanpa kode.
- Aplikasi dan API: buat aplikasi untuk kunci, lalu gunakan sistem sendiri untuk membuat pesanan dan menerima webhook pembayaran. Cocok jika sudah memiliki sistem.
Tentukan model kustodi dahulu
Alamat penerimaan ada dua jenis: alamat kustodi platform dan alamat kelola mandiri. Model kustodi melekat pada alamat, sehingga satu aplikasi dapat memakai kedua jenis alamat sekaligus. Model ini menentukan di mana dana berada, bagaimana biaya ditagih, dan fitur apa yang tersedia, jadi tentukan sebelum mulai menerima pembayaran.
- Kustodi platform — Alamat penerimaan dialokasikan oleh platform. Setelah dikumpulkan, dana yang diterima masuk ke "Dapat ditarik (terkumpul)" di "Aset"; setelah itu dana dapat ditarik ke alamat eksternal, ditransfer ke saldo akun, atau ditarik melalui API.
- Pengelolaan aset mandiri — Impor alamat yang kunci privatnya Anda pegang sendiri di "Kumpulan alamat → Alamat kelola mandiri". Dana langsung masuk ke alamat Anda; platform hanya mendeteksi dana masuk, mengirim notifikasi, dan mencatatnya, tanpa mengumpulkan dana — Anda mengelolanya sendiri.
Dana di alamat kelola mandiri tidak melewati platform dan tidak muncul di "Dapat ditarik (terkumpul)", sehingga tidak dapat ditarik melalui platform maupun melalui penarikan API. Sebelum memilih kelola mandiri, pastikan alur pembayaran keluar Anda tidak bergantung pada kedua jalur ini.
Cara biaya ditagih
- Kustodi platform — Dipotong secara proporsional dari jumlah yang dikumpulkan saat pengumpulan, dengan biaya minimum tersendiri untuk setiap token; jumlah setelah dipotong masuk ke "Dapat ditarik (terkumpul)". Persentasenya adalah tarif yang berlaku untuk akun Anda saat ini, yang bisa berupa tarif bawaan, tarif khusus, atau tarif berjenjang menurut jumlah yang sudah dikumpulkan bulan ini.
- Pengelolaan aset mandiri — Setelah setiap pesanan diterima, jumlah token pesanan itu dikalikan tarif, dikonversi ke dolar AS, dan dipotong dari saldo akun Anda; setiap transaksi memiliki biaya minimum.
Biaya kelola mandiri dipotong dari saldo akun, sehingga saldo bisa menjadi negatif. Jika saldo di bawah 0, aplikasi yang menerima pembayaran dengan alamat kelola mandiri berhenti menerima pesanan baru — pesanan pelanggan pada saat itu akan gagal, sedangkan pesanan yang sudah dibuat tidak terpengaruh; notifikasi dana masuk mode satu-ke-satu juga ditahan sementara. Setelah isi saldo membuat saldo kembali di atas 0, layanan pulih otomatis dan notifikasi yang ditahan dikirim otomatis.
Lihat tarif di "Aturan biaya platform" pada "Aset → Konfigurasi pengumpulan", termasuk tarif yang berlaku, tarif berjenjang menurut volume bulanan, dan biaya minimum setiap token. Baris "Biaya" di detail pesanan menjadi dasar pemotongan untuk alamat kelola mandiri; untuk alamat kustodi platform, angkanya hanya acuan, dan biaya sebenarnya mengikuti perhitungan saat pengumpulan.
Membuat aplikasi pembayaran
- Buat aplikasi dan simpan kredensial: Di "Pembayaran Multichain → Daftar aplikasi", klik "Buat aplikasi". Setelah dibuat, jendela akan menampilkan App ID dan App Key. App Key juga dapat dilihat lagi nanti dengan mengklik "Rahasia" di daftar aplikasi. Aplikasi baru belum memiliki rahasia pengiriman; klik "Atur ulang rahasia pengiriman" di jendela yang sama untuk membuatnya, lalu pasang di server Anda untuk memverifikasi tanda tangan.
- Atur URL callback dan pengalihan: URL callback menerima notifikasi hasil pembayaran dan harus berupa alamat https; URL pengalihan adalah halaman tujuan pelanggan setelah membayar. Fungsinya berbeda, jadi jangan isi dengan alamat yang sama.
- Pilih mode pembayaran: Rotasi memberikan alamat dari kumpulan setiap membuat pesanan; 1-ke-1 menautkan alamat tetap per pelanggan dan mendorong notifikasi dana masuk. Keduanya dapat aktif bersamaan.
- Pilih jaringan dan token yang diterima: Buka tab "Konfigurasi aplikasi" di detail aplikasi. Daftarnya memuat jaringan dan token yang sudah dibuka platform; centang yang ingin diterima aplikasi ini, pilih mata uang fiat untuk harga pesanan, lalu klik "Simpan".
App Key dan rahasia pengiriman adalah kredensial. Melihat rahasia pengiriman secara lengkap, membuat, atau mengatur ulangnya memerlukan verifikasi identitas terlebih dahulu; jika API terbuka aplikasi diaktifkan, melihat atau mengatur ulang App Key juga memerlukan verifikasi identitas. Setelah diatur ulang, nilai lama langsung tidak berlaku dan integrasi yang sedang berjalan akan terputus, jadi jadwalkan waktu peralihan sebelum mengatur ulang.
Menerima pembayaran melalui checkout
Checkout tidak memerlukan kode: konfigurasi menghasilkan tautan dan QR khusus pelanggan. Pengaturan dibagi ke tiga tab.
- Parameter pembayaran — Aplikasi tertaut, mata uang fiat dan kripto bawaan, jumlah minimum, jendela waktu pesanan, URL pengalihan setelah pembayaran berhasil, dan URL notifikasi pembayaran. Jendela waktu pesanan adalah durasi hitung mundur di halaman pembayaran, dapat diatur 5~1440 menit; setelah hitung mundur selesai, pesanan masih dipertahankan 25 menit lagi untuk menangkap pembayaran yang dikirim menjelang batas waktu dan masih menunggu konfirmasi on-chain. Jika URL notifikasi pembayaran diisi, notifikasi dikirim ke sana; jika tidak, notifikasi dikirim ke URL callback aplikasi tertaut.
- Identitas merek — Templat checkout (lima pilihan: Minimalis modern, Merek menonjol, Ringkas, Gaya kripto, dan Profesional tepercaya, dapat diganti kapan saja), Logo, nama merek, warna tema, slogan merek, dan deskripsi — menentukan tampilan yang dilihat pelanggan saat membuka checkout.
- Pengaturan tampilan — Kontak yang ditampilkan kepada pelanggan (email, telepon, Telegram, situs web resmi), apakah pelanggan boleh mengisi catatan pesanan, serta apakah pelanggan wajib meninggalkan kontak beserta jenis kontak yang dapat dipilih.
Jika aplikasi checkout mengaktifkan rotasi, halaman menyatakannya — itu keterangan sumber alamat penerimaan, bukan error.
Pesanan, pesanan checkout, dan log webhook
- "Pesanan": semua pesanan pembayaran ada di sini. Pesanan dari checkout diberi label "Kasir" dan dapat difilter dengan "Sumber pesanan". Detail pesanan memuat informasi on-chain, biaya untuk transaksi tersebut, dan status notifikasi.
- "Pesanan kasir": hanya mencantumkan pesanan dari checkout; dapat difilter menurut menunggu pembayaran, sudah dibayar, kedaluwarsa, dan dibatalkan, serta dapat menyalin tautan checkout setiap pesanan.
- "Log notifikasi": permintaan, respons, dan hasil setiap pengiriman notifikasi. Mulailah diagnosis integrasi di sini untuk melihat apakah notifikasi tidak dikirim atau server Anda tidak menerimanya; catatan yang berhasil maupun gagal dapat dikirim lagi dengan "Kirim ulang".
Aturan notifikasi: notifikasi dianggap terkirim jika server Anda mengembalikan kode status 2xx apa pun dalam 10 detik; platform tidak memeriksa isi respons. Batas waktu habis, kode selain 2xx, atau pengalihan dihitung gagal. Setelah gagal, platform mencoba ulang masing-masing sekali setelah 30 detik, 1 menit, 2 menit, dan 5 menit, lalu setiap 10 menit, hingga maksimal 10 kali percobaan ulang. Setiap notifikasi membawa notify_id unik yang tidak berubah pada percobaan ulang otomatis maupun "Kirim ulang"; gunakan nilai ini untuk menghapus duplikat.
Dana, kumpulan alamat, dan pembayaran keluar
Lokasi dana bergantung model kustodi; halaman ini mencakup tahap-tahap berbeda.
- Kumpulan alamat — Lihat jumlah alamat total, yang tersedia, dan yang tertaut, serta aset di setiap alamat; tambahkan catatan yang hanya terlihat oleh Anda; lepaskan tautan alamat agar kembali ke kumpulan tersedia; alamat kustodi platform dapat dikumpulkan satu per satu dengan "Kumpulkan". Alamat kelola mandiri diimpor melalui pintu "Alamat kelola mandiri"; aturannya ada pada keterangan di bawah.
- Aset — Bagian atas menampilkan saldo akun, "Dapat ditarik (terkumpul)", dan "Di blockchain, belum terkumpul (estimasi)" secara terpisah. Dua angka terakhir tidak dapat dijumlahkan: dana yang masih di blockchain baru dapat ditarik setelah dikumpulkan dan dipotong biaya. Halaman ini juga memiliki pintu masuk ke isi saldo, penarikan, transfer dana, tagihan platform, riwayat pengumpulan, dan konfigurasi pengumpulan.
- Konfigurasi pengumpulan — Lihat "Aturan biaya platform"; di "Pengaturan pengumpulan otomatis", atur ambang pengumpulan per token — pengumpulan berjalan otomatis saat ambang tercapai, dan ambang tidak boleh lebih rendah dari nilai pengumpulan minimum platform; Anda juga dapat mengklik "Kumpulkan semua aset memenuhi syarat sekarang". Ambang yang lebih tinggi berarti pengumpulan lebih jarang, sehingga biaya minimum per pengumpulan juga lebih jarang terkena.
- Penarikan dan transfer dana — "Tarik dana" menarik aset yang dapat ditarik ke alamat eksternal dan memerlukan autentikasi dua faktor yang aktif; halaman menampilkan biaya, jumlah penarikan minimum, dan total potongan untuk setiap token. Biaya dipotong terpisah, sehingga jumlah yang diisi tiba penuh. Anda juga dapat mengatur aturan penarikan otomatis yang berjalan saat ambang tercapai setelah pengumpulan selesai. "Transfer dana" mengonversi aset yang dapat ditarik ke dolar AS dengan kurs saat itu dan memindahkannya ke saldo akun; tindakan ini tidak dapat dibatalkan.
- Transaksi — Transaksi on-chain dari semua alamat di kumpulan alamat. Setiap transaksi menampilkan pesanan terkait; yang tidak cocok dengan pesanan diberi label "Tidak terkait", dan yang tidak menghasilkan pesanan diberi label "Tanpa pesanan".
- API penarikan — Pembayaran keluar terprogram yang hanya memakai aset di "Dapat ditarik (terkumpul)". "Sakelar utama" baru dapat diaktifkan setelah kunci publik pihak integrasi dan minimal satu daftar izin IP diatur, dan kunci API yang dipakai juga harus mencentang "Penarikan melalui API" di "Pengelolaan API". Anda dapat mengatur jeda penarikan, mode pemotongan biaya, batas per transaksi, dan daftar izin alamat; selama masa jeda, penarikan dapat dijeda, dibatalkan, atau langsung diproses di "Catatan penarikan".
Mengimpor alamat kelola mandiri: hanya alamat yang dimasukkan; kunci privat tidak diperlukan dan tidak diterima. Saat mengimpor, gunakan dompet tempat setiap alamat berada untuk menandatangani pesan berupa teks verifikasi dari halaman, sebagai bukti bahwa alamat itu milik Anda. Tanda tangan ini tidak membelanjakan aset dan tidak mengotorisasi transfer apa pun, dan teks tersebut berlaku 15 menit. Jaringan yang dapat diimpor mengikuti tampilan halaman; hanya alamat TRON dan EVM yang didukung, maksimal 20 alamat per impor dan 100 alamat per jaringan. Alamat tidak dapat dihapus jika masih ditautkan ke aplikasi rotasi atau masih memiliki pesanan yang belum kedaluwarsa; menghapusnya juga menghapus catatan transaksi yang terdeteksi untuk alamat itu.
Konfigurasi token: presisi dan offset
Konfigurasi token memiliki dua parameter yang bersama-sama menentukan tampilan jumlah pembayaran pelanggan.
- Presisi: jumlah angka desimal kripto, dapat diatur 2 hingga 10. Disarankan enam untuk USDT / USDC dan dua untuk TRX.
- Offset penerimaan: jika satu alamat memiliki beberapa pesanan belum dibayar, sistem menyesuaikan desimal terakhir agar pesanan dapat dibedakan.
- Offset memiliki jenis dan rentang; rentang harus berada dalam presisi dan hanya mengubah desimal yang diizinkannya.
Karena itu jumlah di halaman pembayaran harus dibayar persis: digit akhir mengenali pesanan. Kelebihan atau kekurangan sedikit dapat membuat transfer tidak dapat dicocokkan.
Integrasi API
Referensi API lengkap ada di pusat dokumentasi pengembang: mekanisme autentikasi tanda tangan, contoh permintaan dan respons, kode error, peristiwa notifikasi, dan verifikasi tanda tangan. Buka langsung melalui "Dokumentasi integrasi API" di bilah samping konsol.
Permintaan pembuatan pesanan ditandatangani dengan App Key; notifikasi yang dikirim platform kepada Anda ditandatangani dengan rahasia pengiriman, jadi verifikasi tanda tangannya di server Anda. "Izinkan API terbuka lainnya" di detail aplikasi nonaktif secara bawaan; saat nonaktif, kredensial aplikasi hanya dapat memanggil endpoint pembayaran dan kurs. Setelah diaktifkan, kredensial dapat dipakai untuk mengkueri layanan lain, tetapi endpoint pemesanan dan penagihan tetap hanya menerima kunci API dari "Pengelolaan API".
Pemecahan masalah
- Pelanggan membayar tetapi tidak ada notifikasi — URL callback salah atau respons server tidak tepat — Periksa "Log notifikasi" terlebih dahulu: jika tidak ada catatan, periksa URL callback di aplikasi, yang harus berupa alamat https; jika ada catatan tetapi gagal, periksa apakah server Anda mengembalikan 2xx dalam 10 detik, lalu klik "Kirim ulang" setelah diperbaiki. Pastikan juga verifikasi tanda tangan memakai rahasia pengiriman yang berlaku saat ini.
- Transfer tidak cocok ke pesanan — Jumlah dibayar berbeda dari jumlah tepat — Satu alamat dapat memiliki beberapa pesanan yang menunggu pembayaran, dan sistem membedakannya melalui offset pada digit akhir jumlah, jadi bayarlah tepat sesuai jumlah yang ditampilkan di halaman. Transfer yang tidak cocok diberi label "Tidak terkait" di "Transaksi".
- Tidak bisa mendapatkan alamat penerimaan — Kumpulan alamat tidak punya alamat kosong dan pengambilan otomatis sudah mencapai batas; atau alamat bergilir tidak memuat alamat untuk jaringan ini — Satu-ke-satu: jika kumpulan alamat Anda tidak punya alamat kosong, platform mengalokasikan secara otomatis, maksimal 1000 alamat per jaringan setiap 24 jam; setelah melewati batas itu, lepaskan tautan alamat yang tidak dipakai lagi atau impor alamat Anda sendiri. Rotasi: jika aplikasi memiliki alamat bergilir, hanya alamat tersebut yang dipakai; pastikan daftarnya memuat alamat untuk jaringan ini.
- API penarikan menyatakan saldo kosong — Dana masih di blockchain menunggu pengumpulan, atau pembayaran diterima di alamat kelola mandiri — Periksa "Dapat ditarik (terkumpul)" di "Aset". Dana yang menunggu pengumpulan dapat dikumpulkan dengan "Kumpulkan semua aset memenuhi syarat sekarang" di "Konfigurasi pengumpulan"; dana di alamat kelola mandiri tidak melewati platform dan tidak dapat ditarik melalui API.
- Aplikasi dengan alamat kelola mandiri tidak bisa menerima pesanan baru — Saldo akun di bawah 0 — Biaya kelola mandiri dipotong dari saldo akun. Setelah isi saldo membuat saldo kembali di atas 0, layanan pulih otomatis dan notifikasi satu-ke-satu yang ditahan dikirim otomatis.
- Alamat satu-ke-satu menerima transfer sangat kecil, tetapi tidak ada pesanan yang dibuat — Dana masuk senilai kurang dari 0.01 dolar AS tidak membuat pesanan — Dana sudah masuk ke alamat, hanya saja tidak dibuat pesanan dan tidak dikirim notifikasi. Transaksi ini terlihat di "Transaksi" dengan label "Tanpa pesanan".
- Membuat pesanan pembayaran baru atau menautkan alamat baru ditolak — Akun sedang dibatasi atau dibekukan — Selama status ini, pesanan pembayaran baru tidak dapat dibuat dan alamat baru tidak dapat ditautkan; pesanan yang sudah ada masih dapat dilihat dan ditutup. Hubungi dukungan untuk penanganan.
Pertanyaan umum
Pelanggan sudah membayar, tetapi sistem saya tidak menerima notifikasi. Apa yang harus dilakukan?
Periksa "Log notifikasi" terlebih dahulu. Jika tidak ada catatan pengiriman, periksa apakah URL callback di aplikasi sudah benar dan berupa alamat https; jika ada pengiriman tetapi gagal, berarti server Anda tidak mengembalikan 2xx dalam 10 detik. Setelah diperbaiki, klik "Kirim ulang" pada catatan tersebut; platform juga akan mengirim ulang otomatis sesuai jadwal percobaan ulang.
Di mana melihat biaya, dan kapan biaya dipotong?
Lihat tarif yang berlaku di "Aturan biaya platform" pada "Aset → Konfigurasi pengumpulan". Biaya untuk dana di alamat kustodi platform dipotong saat pengumpulan; untuk alamat kelola mandiri, biaya dipotong dari saldo akun setiap kali dana masuk. "Biaya" di detail pesanan hanya acuan untuk kustodi platform; biaya sebenarnya mengikuti pengumpulan.
Mengapa pelanggan harus membayar jumlah tepat yang ditampilkan di halaman?
Karena satu alamat dapat memiliki beberapa pesanan yang menunggu pembayaran sekaligus, dan sistem membedakannya melalui offset pada digit akhir jumlah. Jika jumlahnya tidak cocok, transfer itu mungkin tidak dapat dicocokkan otomatis dengan pesanan.
Halaman terkait: Pusat Bantuan · Panduan & Tanya Jawab · Pembayaran Kripto Multichain · Dokumentasi API
Memuat…