API Kartu Virtual
Terbitkan dan kelola kartu virtual Visa / Mastercard secara massal melalui API, dengan dana USDT, untuk tagihan langganan, iklan, dan pengadaan lintas negara, sesuai kebijakan layanan.
- Pencarian BIN: BIN yang tersedia, wilayah yang didukung, dan rentang batas
- Penerbitan dan isi saldo: buat kartu dengan BIN pilihan dan isi saldo sesuai kebutuhan
- Pengelolaan kartu: bekukan, aktifkan kembali, tutup, dan ambil informasi kartu dengan aman
- Transaksi dan webhook: riwayat per transaksi serta peristiwa otorisasi dan penyelesaian secara waktu nyata
Ringkasan
API kartu virtual dapat membuka kartu, menampilkan BIN/detail, mengambil OTP 3DS, kueri transaksi, isi saldo, dan membatalkan; juga saldo USD serta alamat deposit TRON tetap. Semua memakai JSON code/message/data; code=0 berhasil.
URL dasar adalah gateway Anda (origin situs ini). Kartu memakai /api/v1/vcard, akun /api/v1/account.
Semua jumlah USD; penerbitan/isi saldo hanya dibayar dari saldo USD platform. Saldo kurang menghasilkan error.
Autentikasi & Tanda Tangan
Endpoint baca (BIN, daftar, transaksi, pesanan, saldo, alamat) menerima dua kunci langsung. Pergerakan dana dan data sensitif juga wajib HMAC + waktu + nonce: buka, isi saldo, batal, kembalikan, beku/buka, detail lengkap (details), dan 3DS (code). Kebocoran kunci biasa saja tidak dapat memindahkan dana atau membaca data sensitif.
Masuk ke konsol → Alat & Pengaturan → Pengelolaan API → Buat kunci, lalu salin API Key dan Secret Key; Secret hanya tampil sekali.
Buka, isi saldo, batal, pengembalian, beku/buka, detail lengkap/CVV dan 3DS hanya menerima permintaan bertanda tangan; kunci biasa menghasilkan 401. Endpoint baca lain tidak wajib.
Saldo Akun
GET /api/v1/account/balance
Baca saldo USD; alamat deposit TRON ditambahkan bila tersedia. deposit_address null jika kumpulan sementara tidak tersedia; saldo tetap dikembalikan.
Alamat TRON Tetap
GET /api/v1/account/deposit-address
Ambil/tetapkan alamat deposit TRON khusus (USDT/TRX·TRC20). Tanpa pesanan, dana dikonversi otomatis ke USD dan dikreditkan, cocok untuk isi saldo API. Setelah ditetapkan, alamat tetap.
Kolom Respons
Kirim USDT/TRX; setelah dikonfirmasi pemindai blok, dikonversi sesuai kurs ke saldo platform USD tanpa callback.
Status Layanan
GET /api/v1/vcard/info
Mengembalikan status layanan kartu virtual dan saldo USD.
Kolom Respons
Jika saldo akun tidak dapat dibaca, endpoint mengembalikan HTTP 503 alih-alih balance: 0. Saat menerima 503, coba lagi nanti dan jangan anggap sebagai saldo nol.
BIN kartu
GET /api/v1/vcard/bins
Daftar BIN dengan biaya akhir termasuk markup, menurut tingkat API dari konsumsi 30 hari terakhir; konsumsi tinggi lebih murah. can_open=false untuk isi saldo kartu yang ada saja, bukan buka baru.
Buka Kartu Bertanda tangan
POST /api/v1/vcard/cards
Buat kartu baru. Saldo USD dipotong biaya buka + isi saldo + dana kartu; pesanan diproses asinkron melalui antrean.
Kolom Respons
Setelah respons order_id dan status=queued, polling Detail Pesanan sampai completed. Kegagalan otomatis dikembalikan ke saldo.
Timeout/putus koneksi bisa setelah biaya. Jangan nomor baru: ulang out_trade_no sama tanpa biaya ganda, atau kueri GET /api/v1/vcard/orders/by-trade-no/:out_trade_no. Tanpa nomor tidak ada perlindungan dan ulang bisa menagih lagi.
Daftar Kartu
GET /api/v1/vcard/cards
Semua kartu akun: 4 digit akhir, saldo, dapat dipakai, status batal.
Kolom Respons
Daftar kartu hanya mengembalikan field pada tabel di atas. can_return dan fee_return hanya dikembalikan untuk sebagian BIN kartu; jika tidak ada, anggap kartu tidak mendukung pengembalian saldo.
Detail Kartu Bertanda tangan
GET /api/v1/vcard/cards/:id/details
Data sensitif satu kartu: nomor lengkap, CVV, kedaluwarsa, pemegang. Hanya kartu Anda.
Kolom Respons
Catatan: tabel di atas memuat kolom yang dijamin dikembalikan platform; respons mungkin berisi kolom lain, sesuai respons aktual.
Nomor lengkap dan CVV; panggil hanya dari server tepercaya, jangan ungkap di frontend atau log.
Transaksi
GET /api/v1/vcard/cards/:id/transactions
Catatan transaksi/tagihan satu kartu (belanja, isi saldo, dll.); setiap kueri menyinkronkan catatan terbaru secara langsung.
Kolom Respons
Catatan: tabel di atas memuat kolom yang dijamin dikembalikan platform; respons mungkin berisi kolom lain, sesuai respons aktual.
Kode OTP Bertanda tangan
GET /api/v1/vcard/cards/:id/code
Ambil OTP 3DS terbaru untuk verifikasi pembayaran.
Isi ulang Bertanda tangan
POST /api/v1/vcard/cards/:id/recharge
Isi saldo kartu dari saldo USD (jumlah + biaya); diproses asinkron melalui antrean.
Kolom Respons
Timeout/putus koneksi bisa setelah biaya. Jangan nomor baru: ulang out_trade_no sama tanpa biaya ganda, atau kueri GET /api/v1/vcard/orders/by-trade-no/:out_trade_no. Tanpa nomor tidak ada perlindungan dan ulang bisa menagih lagi.
Batal Bertanda tangan
POST /api/v1/vcard/cards/:id/cancel
Ajukan pembatalan asinkron. Setelah bank mengonfirmasi (bisa beberapa hari), sisa saldo otomatis kembali ke akun.
Pengembalian Saldo Bertanda tangan
POST /api/v1/vcard/cards/:id/return
Mengembalikan sisa saldo kartu ke saldo akun Anda tanpa membatalkan kartu. Biaya dipotong dari jumlah yang dikembalikan dan jumlah bersihnya dikreditkan otomatis. Hanya didukung pada sebagian BIN: dapat dipanggil bila can_return bernilai true di daftar kartu; fee_return adalah biaya pengembalian untuk BIN tersebut.
Hanya satu pengembalian berjalan per kartu; kirim ulang sebelum selesai menghasilkan 400. Tunggu status akhir, jangan mengulang.
Bekukan / aktifkan kembali Bertanda tangan
POST /api/v1/vcard/cards/:id/freeze
Membekukan atau mencairkan kartu. Setiap operasi dikenai biaya kecil (lihat status_fee di daftar kartu). Hanya dapat dipanggil bila can_freeze bernilai true; mengembalikan 400 jika kartu sudah berada dalam status yang diminta atau operasi sebelumnya masih berjalan.
Isi saldo otomatis (aturan saldo) Bertanda tangan
GET /api/v1/vcard/balance-rules
GET /api/v1/vcard/cards/:id/balance-rule
PUT /api/v1/vcard/cards/:id/balance-rule
DELETE /api/v1/vcard/cards/:id/balance-rule
POST /api/v1/vcard/cards/:id/balance-rule/resume
Mengisi saldo kartu secara otomatis saat saldonya turun di bawah jumlah yang ditetapkan, atau hanya mengirim pengingat. Setiap kartu punya satu aturan; PUT membuat atau menggantinya. Isi saldo otomatis memakai jalur penagihan yang sama dengan isi saldo manual (batas dan biaya sama) dan berjalan saat saldo kartu berubah atau pada pemeriksaan tiap menit.
Batas keamanan: jumlah isi saldo per hari (1–10, menurut zona waktu akun) dan batas jumlah bulanan wajib diisi. Aturan berhenti sementara dan memberi tahu Anda jika kartu dibekukan atau sedang ditutup, penerbit menolak karena penipuan, 3 transaksi berturut-turut ditolak, atau saldo akun kurang 3 kali berturut-turut. Panggil resume untuk melanjutkan (aturan yang dihentikan platform tidak bisa Anda lanjutkan sendiri).
Kunci API dengan batas pengeluaran harian tidak bisa membuat atau melanjutkan isi saldo otomatis (403, kode 4035): platform menagih isi saldo otomatis di latar belakang, di luar batas kunci. Aturan yang hanya mengingatkan tidak terpengaruh.
Langganan
GET /api/v1/vcard/subscriptions
Tagihan berulang yang dikenali dari transaksi kartu aktif Anda (hanya baca, dihitung saat itu): tagihan berulang dari merchant yang sama dengan jarak sekitar seminggu, sebulan, atau setahun dianggap langganan. Untuk menghentikannya, bekukan atau tutup kartunya.
Batasi merchant Bertanda tangan
GET /api/v1/vcard/merchant-locks
GET /api/v1/vcard/cards/:id/merchant-lock
PUT /api/v1/vcard/cards/:id/merchant-lock
DELETE /api/v1/vcard/cards/:id/merchant-lock
Menetapkan merchant yang boleh dipakai dengan sebuah kartu. Jika muncul transaksi dari merchant lain, kartu dibekukan otomatis (satu kali biaya pembekuan) atau Anda hanya diberi tahu. Hanya transaksi setelah pengaturan disimpan yang diperiksa, dan pembekuan terjadi sesudahnya — transaksi pertama di luar daftar sudah diotorisasi.
Grup kartu
GET /api/v1/vcard/groups
POST /api/v1/vcard/groups
PUT /api/v1/vcard/groups/:gid
DELETE /api/v1/vcard/groups/:gid
POST /api/v1/vcard/cards/group
Kelompokkan kartu, masing-masing dengan anggaran bulanan opsional: Anda mendapat satu peringatan di 80% dan satu saat terlampaui; transaksi tidak pernah diblokir. Satu kartu hanya ada di satu grup; group_id 0 mengeluarkannya dari grup. Maksimal 20 grup.
Tagihan bulanan
GET /api/v1/vcard/bill/export
Transaksi kartu selama sebulan, bisa untuk satu kartu atau satu grup, dari yang terlama. Hanya transaksi selama Anda memegang kartu yang disertakan; jika lebih dari 20.000 baris Anda mendapat 400 — ekspor per kartu atau per grup.
Daftar pesanan
GET /api/v1/vcard/orders
Daftar pesanan buka/isi saldo/batal berpaginasi.
Detail Pesanan
GET /api/v1/vcard/orders/:id
Kueri satu pesanan untuk polling hasil buka/isi saldo.
Objek pesanan sama persis dengan Kueri Pesanan.
Cari pesanan melalui nomor Anda
GET /api/v1/vcard/orders/by-trade-no/:out_trade_no
Mencari pesanan berdasarkan out_trade_no yang dikirim saat membuka atau mengisi ulang kartu. Responsnya sama dengan "Detail pesanan". Mengembalikan 404 jika nomor tidak ditemukan.
Ubah Catatan
PUT /api/v1/vcard/cards/:id/remark
Atur catatan kartu, maksimum 60 karakter.
Push Webhook
Saat kartu dibuka/diisi/dibatalkan, transaksi atau 3DS baru, platform mengirim POST JSON tanpa polling. Atur di Konsol → Kartu Virtual → Integrasi API: aktifkan, URL, Secret, peristiwa; kosong berarti semua.
Endpoint https publik; JSON datar dengan semua nilai teks. 2xx berarti berhasil; lainnya dicoba ulang eksponensial 30 detik → 1 menit → 2 menit → 5 menit → 10 menit, hingga 10 percobaan. notify_id tetap untuk deduplikasi idempoten.
Kolom umum setiap peristiwa; kolom khusus di bawah:
Verifikasi: ambil semua kolom tidak kosong selain "sign", urutkan kunci ASC, gabung k=v&k2=v2, hitung HMAC-SHA256 heksadesimal kecil dengan Secret, bandingkan sign. sign_ts harus ±5 menit dan nonce belum digunakan. Gagal pemeriksaan: tolak 401.
Peristiwa dan kolom khusus:
Pertanyaan umum
Seberapa cepat kartu dapat digunakan dan di mana dapat dipakai?
Penerbitan biasanya mengembalikan informasi kartu dalam hitungan detik. Kartu digunakan untuk pembayaran daring Visa / Mastercard seperti langganan AI, iklan, dan belanja lintas negara; penerimaan bergantung pada BIN, penerbit, wilayah, dan kebijakan penjual.
Bagaimana menelusuri transaksi yang ditolak?
Periksa endpoint riwayat transaksi untuk kode alasan penolakan otorisasi — umumnya saldo tidak cukup, kategori penjual dibatasi, atau diblokir pengendalian risiko. Peristiwa otorisasi dan penyelesaian juga dikirim melalui webhook untuk rekonsiliasi.
Halaman terkait: Kartu virtual · Dokumentasi API · Pembayaran Kripto Multichain
Memuat…