Membuat pembayaran
Pembayaran melalui API hanya dilakukan dari saldo dompet bisnis Anda.
Pembayaran dapat dilakukan dengan berbagai cara:
- Anda dapat memilih untuk menerima pembayaran dalam mata uang kripto tertentu, dan pembayaran akan diproses secara otomatis dalam mata uang kripto tersebut. Untuk melakukannya, pastikan Anda memiliki saldo yang cukup dalam mata uang tersebut untuk menutupi semua biaya terkait.
- Sebagai alternatif, Anda memiliki opsi untuk menentukan jumlah pembayaran dalam mata uang fiat. Dalam hal ini, jumlah tersebut akan secara otomatis dikonversi ke mata uang kripto tertentu dari saldo Anda yang tersedia. Misalnya, jika Anda meminta pembayaran sebesar 20 USD dalam LTC, nilai yang setara akan dipotong dari saldo LTC Anda. Penting untuk memiliki dana yang cukup dalam mata uang kripto yang sesuai untuk menutupi semua biaya yang berlaku.
- Kemungkinan lainnya adalah menentukan jumlah pembayaran dalam mata uang fiat, yang akan otomatis dikonversi ke mata uang kripto tertentu menggunakan saldo USDT Anda. Opsi ini sangat berguna jika Anda mengaktifkan konversi otomatis, karena dana dari faktur Anda akan otomatis dikonversi ke USDT. Misalnya, jika Anda ingin melakukan pembayaran sebesar 20 USD dalam LTC tetapi hanya memiliki saldo dalam USDT, pastikan Anda memiliki dana USDT yang cukup untuk menutupi semua biaya.
- Selain itu, Anda dapat memilih jumlah pembayaran dalam mata uang kripto pilihan Anda. Pembayaran kemudian akan diproses secara otomatis dalam mata uang kripto tersebut, menggunakan saldo USDT Anda yang tersedia. Sangat penting untuk memiliki saldo USDT yang cukup untuk menutupi semua biaya terkait.
Meminta
Parameter kueri
Nama | Jenis parameter | Nilai default | Definisi |
---|---|---|---|
amount* | string | Jumlah pembayaran | |
currency* | string | Kode mata uang untuk pembayaranJika mata uangnya fiat, parameter to_currency diperlukan. | |
order_id* | stringmin:1max:100alpha_dash | ID Pesanan di sistem AndaParameter harus berupa string yang terdiri dari karakter alfabet, angka, garis bawah, dan tanda hubung. Parameter tidak boleh mengandung spasi atau karakter khusus.order_id harus unik dalam pembayaran pedagangKetika kami menemukan pembayaran yang ada dengan order_id, kami mengembalikan detailnya, pembayaran baru tidak akan dibuat. | |
address* | string | Alamat dompet tempat penarikan akan dilakukan | |
is_subtract* | boolean | Menentukan di mana biaya penarikan akan dipotongbenar - dari saldo Andasalah - dari jumlah pembayaran, jumlah pembayaran akan dikurangi | |
network* | string | Kode jaringan BlockchainTidak diperlukan ketika currency/to_currency adalah mata uang kripto dan hanya memiliki satu jaringan, misalnya BTC | |
url_callback | URL tempat webhook dengan status pembayaran akan dikirim | ||
to_currency | Kode mata uang kripto yang akan digunakan untuk pembayaran. Kode ini digunakan ketika parameter mata uang adalah fiat. Lihat contoh di bawah ini. | ||
course_source | stringNilai yang tersedia• Binance• BinanceP2p• Exmo• Kucoin | Nilai dari pengaturan pedagang | Layanan yang digunakan untuk mengambil nilai tukar dan mengonversikannya ke faktur.Parameter hanya diterapkan jika mata uangnya fiat, jika tidak, nilai default diambil dari pengaturan pedagang. |
from_currency | string | null | Memungkinkan konversi otomatis jumlah penarikan dan penggunaan saldo from_currency. Hanya USDT yang tersedia. |
priority | stringmin: 4max: 11Nilai yang tersedia• recommended• economy• high• highest | recommended | Parameter untuk memilih prioritas penarikan. Biaya penarikan bergantung pada parameter yang dipilih.Parameter ini hanya diterapkan jika menggunakan jaringan BTC, ETH, POLYGON, dan BSC. |
memo | stringmin: 1max: 30 | Pengidentifikasi tambahan untuk TON, digunakan untuk menentukan penerima atau target tertentu |
Jenis parameter
stringDefinisi
Jumlah pembayaranJenis parameter
stringDefinisi
Kode mata uang untuk pembayaranJika mata uangnya fiat, parameter to_currency diperlukan.Jenis parameter
stringmin:1max:100alpha_dashDefinisi
ID Pesanan di sistem AndaParameter harus berupa string yang terdiri dari karakter alfabet, angka, garis bawah, dan tanda hubung. Parameter tidak boleh mengandung spasi atau karakter khusus.order_id harus unik dalam pembayaran pedagangKetika kami menemukan pembayaran yang ada dengan order_id, kami mengembalikan detailnya, pembayaran baru tidak akan dibuat.Jenis parameter
stringDefinisi
Alamat dompet tempat penarikan akan dilakukanJenis parameter
booleanDefinisi
Menentukan di mana biaya penarikan akan dipotongbenar - dari saldo Andasalah - dari jumlah pembayaran, jumlah pembayaran akan dikurangiJenis parameter
stringDefinisi
Kode jaringan BlockchainTidak diperlukan ketika currency/to_currency adalah mata uang kripto dan hanya memiliki satu jaringan, misalnya BTCDefinisi
URL tempat webhook dengan status pembayaran akan dikirimDefinisi
Kode mata uang kripto yang akan digunakan untuk pembayaran. Kode ini digunakan ketika parameter mata uang adalah fiat. Lihat contoh di bawah ini.Jenis parameter
string
Nilai yang tersedia- Binance- BinanceP2p- Exmo- KucoinDefinisi
Layanan yang digunakan untuk mengambil nilai tukar dan mengonversikannya ke faktur.Parameter hanya diterapkan jika mata uangnya fiat, jika tidak, nilai default diambil dari pengaturan pedagang.Jenis parameter
stringDefinisi
Memungkinkan konversi otomatis jumlah penarikan dan penggunaan saldo from_currency. Hanya USDT yang tersedia.Jenis parameter
stringmin: 4max: 11
Nilai yang tersedia- recommended- economy- high- highestDefinisi
Parameter untuk memilih prioritas penarikan. Biaya penarikan bergantung pada parameter yang dipilih.Parameter ini hanya diterapkan jika menggunakan jaringan BTC, ETH, POLYGON, dan BSC.Jenis parameter
stringmin: 1max: 30Definisi
Pengidentifikasi tambahan untuk TON, digunakan untuk menentukan penerima atau target tertentu
* - parameter wajib
Contoh permintaan
curl https://api.cryptomus.com/v1/payout \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "5",
"currency": "USDT",
"network": "TRON",
"order_id": "1",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"url_callback": "https://your.site/callback",
"is_subtract": "1",
}'
MenyalinTanggapan
Parameter respons
Nama | Definisi |
---|---|
uuid | uuid pembayaran |
amount | Jumlah pembayaran dalam mata uang |
currency | Kode mata uang untuk pembayaran |
network | Kode jaringan blockchain tempat pembayaran dilakukan |
address | Alamat dompet tempat pembayaran dilakukan |
txid | ID Transaksi di blockchain |
status | Status pembayaran Lihat semua status yang tersedia |
is_final | Apakah pembayaran sudah selesaiProses pembayaran dianggap selesai setelah pembayaran berhasil atau gagal. Jika pembayaran gagal, dana akan dikembalikan ke saldo Anda, sehingga Anda harus memulai kembali proses pembayaran. |
balance | Dana yang tersisa pada saldo pedagang. |
payer_currency | Kode mata uang kripto tempat pembayaran akan dilakukan. Alamat pembayaran akan menerima mata uang pembayaran. |
payer_amount | Jumlah dalam payer_currency dari pembayaran. |
Definisi
uuid pembayaranDefinisi
Jumlah pembayaran dalam mata uangDefinisi
Kode mata uang untuk pembayaranDefinisi
Kode jaringan blockchain tempat pembayaran dilakukanDefinisi
Alamat dompet tempat pembayaran dilakukanDefinisi
ID Transaksi di blockchainDefinisi
Status pembayaran Lihat semua status yang tersediaDefinisi
Apakah pembayaran sudah selesaiProses pembayaran dianggap selesai setelah pembayaran berhasil atau gagal. Jika pembayaran gagal, dana akan dikembalikan ke saldo Anda, sehingga Anda harus memulai kembali proses pembayaran.Definisi
Dana yang tersisa pada saldo pedagang.Definisi
Kode mata uang kripto tempat pembayaran akan dilakukan. Alamat pembayaran akan menerima mata uang pembayaran.Definisi
Jumlah dalam payer_currency dari pembayaran.
Contoh respons
1{
2 "state": 0,
3 "result": {
4 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
5 "amount": "3",
6 "currency": "USDT",
7 "network": "TRON",
8 "address": "TJ...",
9 "txid": null,
10 "status": "process",
11 "is_final": false,
12 "balance": 129,
13 "payer_currency": "USD",
14 "payer_amount": 3
15 }
16}
17
MenyalinKemungkinan kesalahan
Kesalahan validasi
kode : 422
contoh tanggapan:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}
MenyalinJika pembayaran diblokir di akun pedagang atau pengguna Anda, Anda akan menerima pesan kesalahan ini. Hal ini terjadi, misalnya, ketika Anda mengubah kata sandi dan pembayaran diblokir selama 24 jam.
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
MenyalinJika kami tidak mendukung kode mata uang yang Anda berikan di parameter mata uang, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "The currency was not found"
4}
MenyalinJika kami tidak dapat menemukan layanan untuk melakukan pembayaran, Anda akan menerima pesan kesalahan ini. Anda harus memastikan bahwa mata uang kripto tersebut didukung. Periksa kebenaran nilai yang dimasukkan dalam: mata uang, jaringan, dari_mata_uang, ke_mata_uang:
1{
2 "state": 1,
3 "message": "The service was not found"
4}
MenyalinJika jumlah penarikan terlalu kecil, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "The withdrawal amount is too small"
4}
MenyalinJika Anda tidak memiliki dompet pedagang aktif dengan mata uang kripto pembayaran, Anda akan menerima kesalahan ini:
1{
2 "state": 1,
3 "message": "Wallet not found"
4}
MenyalinJika jumlah pembayaran, termasuk semua komisi, lebih besar dari saldo Anda, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}
MenyalinJika kami tidak menemukan layanan pembayaran mata uang yang dimasukkan dalam parameter to_currency, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Not found service to_currency"
4}
MenyalinJika secara tidak sengaja terjadi sesuatu saat mengonversi ke to_currency, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Error convert to_currency"
4}
MenyalinJika jumlah pembayaran kurang dari jumlah minimum yang didukung untuk mata uang kripto, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Minimum amount 0.5 USDT"
4}
MenyalinJika jumlah pembayaran lebih besar dari jumlah maksimum yang didukung untuk mata uang kripto, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Maximum amount 10000000 USDT"
4}
MenyalinJika Anda tidak memiliki cukup dana untuk melakukan pembayaran, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}
MenyalinJika Anda tidak memiliki cukup dana untuk mengonversi jumlah pembayaran dari from_currency, Anda akan menerima pesan kesalahan ini:
1{
2 "state": 1,
3 "message": "Not enough balance for convert USDT to LTC"
4}
MenyalinJika terjadi pekerjaan teknis dan pembayaran tidak tersedia untuk sementara, Anda akan menerima pesan kesalahan ini
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}
MenyalinKesalahan server internal
kode : 500
contoh tanggapan:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}
Menyalin