Untuk menerima USDC online, tentukan lebih dahulu representasi token dan rute blockchain yang benar-benar didukung bisnis. Buat satu permintaan pembayaran untuk setiap pesanan, tampilkan token, jaringan, jumlah, alamat, dan masa berlaku bersama-sama, lalu tandai pesanan dibayar hanya dari hasil server yang tepercaya. Transfer manual dapat digunakan untuk penjualan langka; payment link terlacak lebih aman untuk tagihan via chat atau email; invoice API cocok ketika situs harus menghubungkan pembayaran dengan pesanan secara otomatis.

KeputusanJawaban minimum yang aman
Aset apa yang diterima?Kontrak atau mint USDC persis yang dikonfigurasi untuk jaringan tertentu
Implementasi apa?Transfer manual, link terlacak, atau invoice API sesuai alur penjualan
Apa yang dilihat pelanggan?Tujuan, jumlah tepat, jaringan, alamat/QR, expiry, dan status
Kapan pesanan dibayar?Setelah transaksi terkonfirmasi dan cocok dengan invoice yang benar
Ke mana dana masuk?Wallet merchant, saldo provider, atau payout fiat yang dipilih sebelum peluncuran

Tentukan USDC mana yang diterima

USDC adalah stablecoin berdenominasi dolar yang diterbitkan Circle pada beberapa blockchain. Circle menyatakan aset ini didukung kas dan setara kas yang sangat likuid serta menerbitkan informasi cadangan di halaman transparansi. Informasi issuer membantu menilai aset, tetapi tidak otomatis membuat rute checkout aman.

Setiap rute harus menetapkan blockchain, kontrak atau mint token, dan alamat penerima. Ticker USDC saja tidak cukup. Wallet dapat menampilkan USDC native dari Circle dan representasi bridged atau pegged dengan nama yang sama. Circle menerbitkan alamat kontrak resmi USDC dan membedakan versi seperti USDC.e yang mungkin tidak diterbitkan atau dijamin Circle.

Jangan menyalin seluruh jaringan Circle ke checkout. Dukungan issuer tidak berarti wallet merchant, exchange pelanggan, dan produk pembayaran mendukung rute yang sama. Konfigurasi live dan kontrak tepat yang ditampilkan checkout adalah sumber akhir bagi pembeli.

Pilih model sesuai proses penjualan

ModelCocok untukTanggung jawab bisnis
Transfer wallet manualSedikit pembayaran yang diawasiInstruksi, verifikasi, pencocokan, dan exception
Payment link terlacakJasa dan penjualan melalui chat/emailMembuat invoice, wallet, refund, dan catatan
API dan hosted checkoutEcommerce, SaaS, dan layanan onlineLocal order, integrasi, fulfilment, dan exception
Processor custodialBisnis menerima saldo providerAkses, withdrawal, dan rekonsiliasi
Settlement terkonversiBisnis menginginkan fiat atau aset lainKelayakan, payout, konversi, dan akuntansi

Alamat wallet berulang tidak membawa konteks komersial. Jika dua pelanggan mengirim 100 USDC ke alamat yang sama, blockchain tidak tahu produk atau pesanan yang dibayar. Payment link memberi setiap kewajiban jumlah, waktu, dan status sendiri. API menghubungkan invoice dengan order ID sebelum pelanggan membayar.

Konsultan dengan satu tagihan bulanan mungkin cukup memakai link; layanan yang memberi akses tanpa operator memerlukan status server-side dan fulfilment yang aman dari pengulangan. Lihat use case payment link dan use case pembayaran situs.

Aktifkan jaringan berdasarkan penggunaan nyata

Untuk setiap rute, pastikan wallet atau exchange pelanggan dapat mengirim representasi USDC yang tepat, wallet merchant mengenali kontraknya, produk memonitor contract/mint yang sama, dan tim memahami network fee serta refund.

GramPayBot saat ini menyediakan rute USDC terkonfigurasi pada Ethereum, Optimism, BNB Smart Chain, Base, Polygon, Arbitrum, dan Solana. Tidak semuanya tepat disebut USDC native dari Circle: kontrak BNB Smart Chain saat ini tidak tercantum dalam daftar kontrak native Circle. Perlakukan katalog dan alamat kontraknya sebagai informasi produk terkini, bukan janji permanen issuer. Aktifkan hanya rute yang terlihat di proyek dan didukung wallet penerima. Baca wallet dan jaringan.

Lebih banyak jaringan tidak otomatis meningkatkan conversion. Setiap rute menambah saldo, jalur refund, token untuk gas, dan skenario support. Dua rute yang telah diuji dan digunakan pelanggan lebih baik daripada daftar panjang yang tidak dikuasai tim.

Buat satu invoice per kewajiban

Buat terlebih dahulu pesanan ecommerce, top-up, paket, atau tahap proyek di sistem merchant dan berikan ID immutable. Lalu buat payment invoice dan simpan ID yang dikembalikan bersama pesanan. Pada API, kirim referensi lokal melalui payload dan gunakan Idempotency-Key stabil agar retry setelah timeout tidak membuat dua checkout aktif.

Hubungan ini memisahkan dua pertanyaan: apakah transfer USDC valid tiba dan pesanan mana yang boleh dilanjutkan? Blockchain menjawab yang pertama; relasi order-to-invoice menjawab yang kedua. Model lengkap dibahas dalam cara mencocokkan pembayaran kripto dengan pesanan.

Tampilkan satu instruksi lengkap

Checkout harus menyatukan tujuan, jumlah USDC tepat, nama jaringan lengkap, alamat dan QR, waktu tersisa, serta status. Jangan kirim alamat dan jaringan dalam pesan terpisah. Banyak jaringan EVM memakai format 0x, sehingga wallet tidak dapat menyimpulkan rute dari alamat. Untuk withdrawal exchange, label network harus sama dengan checkout.

Jangan mengasumsikan token decimals. USDC native Circle umumnya menggunakan enam, sedangkan rute BNB Smart Chain GramPayBot saat ini memakai 18. Tampilkan amount dari invoice, ambil precision dari route catalog, dan gunakan decimal arithmetic, bukan binary float.

Verifikasi di server

Return page adalah antarmuka, bukan bukti settlement. Tab dapat ditutup sebelum konfirmasi, URL lama dibuka kembali, dan state client-side dimanipulasi. Screenshot atau tx hash dari pelanggan juga belum cukup; hash nyata dapat menunjuk token, jaringan, recipient, jumlah, atau order yang salah.

Untuk pemeriksaan manual, bandingkan status, token contract, recipient, dan amount pada explorer yang benar mengikuti checklist verifikasi. Situs otomatis harus memakai API authenticated atau webhook signed. Simpan tx hash dan timestamp bersama order.

Handler harus idempotent. Verifikasi signature atas raw body, simpan event/delivery key stabil, jawab cepat, dan pastikan fulfilment hanya commit sekali. Event paid berulang tidak boleh menyerahkan dua produk atau menambah saldo dua kali.

Tentukan custody, settlement, dan exception

Provider dapat mengkredit saldo internal, mengonversi ke fiat, atau memonitor direct-to-wallet saat dana langsung masuk ke alamat merchant. Ketiganya berbeda. Gambarkan jalur dana dan bandingkan akses, conversion, fee, payout, serta refund. Dalam model langsung, layanan hanya memerlukan public address; jangan pernah berbagi seed phrase atau private key.

Tetapkan aturan untuk pembayaran terlambat, kurang/lebih, kontrak lain, jaringan salah, invoice lama, dan refund. Jangan diam-diam mengubahnya menjadi paid. Simpan evidence dan kirim ke review resmi. Transfer wrong-network mungkin tidak dapat dipulihkan; monitoring service tidak dapat menandatangani refund dari wallet merchant.

Pilih rute USDC yang didukung

Periksa matriks rute lengkap sebelum mengaktifkan jaringan. Bandingkan USDC native di Ethereum, Base, Polygon, dan Arbitrum dengan aset tepat yang ditawarkan pengirim.

Peran GramPayBot

GramPayBot membuat invoice USDC secara manual atau API, menyediakan hosted checkout, dan memonitor rute yang didukung sementara dana masuk langsung ke public wallet merchant. Situs mengirim order reference dalam payload dan menerima status melalui API atau signed webhook.

GramPayBot menangani payment request, checkout, dan hasil transaksi. Merchant mengendalikan order, wallet, fulfilment, refund, treasury, serta akuntansi. Sebelum menyerahkan produk otomatis, terapkan API quickstart dan signed webhooks.

Mulai dengan satu produk, satu jaringan, dan transfer nyata bernilai kecil. Periksa contract, penerimaan, status paid, order reference, dan tx hash. Lalu uji expiry, webhook duplikat, serta amount salah tanpa fulfilment. Alur USDC yang baik memberi pelanggan satu instruksi jelas dan bisnis satu hasil terverifikasi yang terhubung ke pesanan.

Langkah berikutnya

Otomatiskan verifikasi di website

Buat invoice untuk setiap pesanan, gunakan hosted checkout, dan terima hasil terkait pesanan.

Lihat pembayaran website →