Membuat pembayaran

post
https://api.cryptomus.com/v1/payout
Menyalin

Pembayaran melalui API hanya dilakukan dari saldo dompet bisnis Anda.

Pembayaran dapat dilakukan dengan berbagai cara:

  1. 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.
  2. 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.
  3. 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.
  4. 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

NamaJenis parameterNilai defaultDefinisi
amount*stringJumlah pembayaran
currency*stringKode mata uang untuk pembayaranJika mata uangnya fiat, parameter to_currency diperlukan.
order_id*stringmin:1max:100alpha_dashID 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*stringAlamat dompet tempat penarikan akan dilakukan
is_subtract*booleanMenentukan di mana biaya penarikan akan dipotongbenar - dari saldo Andasalah - dari jumlah pembayaran, jumlah pembayaran akan dikurangi
network*stringKode jaringan BlockchainTidak diperlukan ketika currency/to_currency adalah mata uang kripto dan hanya memiliki satu jaringan, misalnya BTC
url_callbackURL tempat webhook dengan status pembayaran akan dikirim
to_currencyKode mata uang kripto yang akan digunakan untuk pembayaran. Kode ini digunakan ketika parameter mata uang adalah fiat. Lihat contoh di bawah ini.
course_sourcestringNilai yang tersediaBinanceBinanceP2pExmoKucoinNilai dari pengaturan pedagangLayanan 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_currencystringnullMemungkinkan konversi otomatis jumlah penarikan dan penggunaan saldo from_currency. Hanya USDT yang tersedia.
prioritystringmin: 4max: 11Nilai yang tersediarecommendedeconomyhighhighestrecommendedParameter untuk memilih prioritas penarikan. Biaya penarikan bergantung pada parameter yang dipilih.Parameter ini hanya diterapkan jika menggunakan jaringan BTC, ETH, POLYGON, dan BSC.
memostringmin: 1max: 30Pengidentifikasi tambahan untuk TON, digunakan untuk menentukan penerima atau target tertentu

Jenis parameter

string

Definisi

Jumlah pembayaran

Jenis parameter

string

Definisi

Kode mata uang untuk pembayaranJika mata uangnya fiat, parameter to_currency diperlukan.

Jenis parameter

stringmin:1max:100alpha_dash

Definisi

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

string

Definisi

Alamat dompet tempat penarikan akan dilakukan

Jenis parameter

boolean

Definisi

Menentukan di mana biaya penarikan akan dipotongbenar - dari saldo Andasalah - dari jumlah pembayaran, jumlah pembayaran akan dikurangi

Jenis parameter

string

Definisi

Kode jaringan BlockchainTidak diperlukan ketika currency/to_currency adalah mata uang kripto dan hanya memiliki satu jaringan, misalnya BTC

Definisi

URL tempat webhook dengan status pembayaran akan dikirim

Definisi

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- Kucoin

Definisi

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

string

Definisi

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- highest

Definisi

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: 30

Definisi

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",
}'
Menyalin

Tanggapan

Parameter respons

NamaDefinisi
uuiduuid pembayaran
amountJumlah pembayaran dalam mata uang
currencyKode mata uang untuk pembayaran
networkKode jaringan blockchain tempat pembayaran dilakukan
addressAlamat dompet tempat pembayaran dilakukan
txidID Transaksi di blockchain
statusStatus pembayaran Lihat semua status yang tersedia
is_finalApakah 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.
balanceDana yang tersisa pada saldo pedagang.
payer_currencyKode mata uang kripto tempat pembayaran akan dilakukan. Alamat pembayaran akan menerima mata uang pembayaran.
payer_amountJumlah dalam payer_currency dari pembayaran.

Definisi

uuid pembayaran

Definisi

Jumlah pembayaran dalam mata uang

Definisi

Kode mata uang untuk pembayaran

Definisi

Kode jaringan blockchain tempat pembayaran dilakukan

Definisi

Alamat dompet tempat pembayaran dilakukan

Definisi

ID Transaksi di blockchain

Definisi

Status pembayaran Lihat semua status yang tersedia

Definisi

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
Menyalin

Kemungkinan kesalahan

Kesalahan validasi

kode : 422

contoh tanggapan:


1{
2	"state": 1,
3	"errors": {
4		"amount": ["validation.required"]
5	}
6}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika jumlah penarikan terlalu kecil, Anda akan menerima pesan kesalahan ini:


1{
2    "state": 1,
3    "message": "The withdrawal amount is too small"
4}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Jika Anda tidak memiliki cukup dana untuk melakukan pembayaran, Anda akan menerima pesan kesalahan ini:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}
Menyalin

Jika 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}
Menyalin

Jika 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}
Menyalin

Kesalahan server internal

kode : 500

contoh tanggapan:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
Menyalin