Ödeme Yaratmak

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

API aracılığıyla ödemeler yalnızca iş cüzdanları bakiyelerinizden yapılmıştır.

Ödemeler farklı şekillerde yapılabilir:

  1. Ödemeyi belirli bir kripto para biriminde almayı seçebilirsiniz ve ödeme, bu belirli kripto para biriminde otomatik olarak işlenir. Bunu yapmak için, ilgili tüm ücretleri karşılamak için söz konusu para biriminde yeterli dengeye sahip olduğunuzdan emin olun.
  2. Alternatif olarak, ödeme tutarını bir fiat para biriminde belirleme seçeneğiniz vardır. Bu durumda, miktar otomatik olarak mevcut bakiyenizden belirli bir kripto para birimine dönüştürülecektir. Örneğin, LTC'de 20 USD ödeme talep ederseniz, eşdeğer değer LTC bakiyenizden düşülecektir. Geçerli tüm ücretleri karşılamak için ilgili kripto para biriminde yeterli fona sahip olmak önemlidir.
  3. Başka bir olasılık, USDT bakiyenizi kullanarak otomatik olarak belirli bir kripto para birimine dönüştürülecek olan bir fiat para biriminde ödeme tutarını belirtmektir. Bu seçenek, faturalarınızdaki fonlar otomatik olarak USDT'ye dönüştürüldüğünden, otomatik olarak etkin olduğunuzda özellikle kullanışlıdır. Örneğin, LTC'de 20 USD ödeme yapmak istiyorsanız, ancak yalnızca USDT'de bir bakiyeniz varsa, tüm ücretleri karşılamak için yeterli USDT fonunuz olduğundan emin olun.
  4. Ayrıca, ödeme tutarını tercihinizin herhangi bir kripto para biriminde belirtmeyi seçebilirsiniz. Ödeme daha sonra, mevcut USDT bakiyenizi kullanarak bu belirli kripto para biriminde otomatik olarak işlenecektir. İlgili tüm ücretleri karşılamak için yeterli USDT dengesine sahip olmak çok önemlidir.

Rica etmek

Sorgu parametreleri

İsimParametre türüVarsayılan değerTanım
amount*stringÖdeme tutarı
currency*stringÖdeme için para birimi koduPara birimi ise fiat, to_currency parametresi gereklidir.
order_id*stringmin:1max:100alpha_dashSisteminizde Sipariş KimliğiParametre, alfabetik karakterler, sayılar, alt çizgiler ve çizgilerden oluşan bir dize olmalıdır. Herhangi bir alan veya özel karakter içermemelidir. order_id satıcı ödemeleri içinde benzersiz olmalı order_id ile mevcut bir ödeme bulduğumuzda, ayrıntılarını döndürürüz, yeni bir ödeme oluşturulmayacaktır.
address*stringÇekilmenin yapılacağı cüzdanın adresi
is_subtract*booleanPara çekme ücretinin nereden düşüleceğini tanımlarDoğru - DengenizdenYanlış - Ödeme tutarından ödeme tutarı azalacak
network*stringBlockchain Ağ Kodu para birimi/to_currency bir kripto para birimi olduğunda ve örneğin BTC gibi yalnızca bir ağa sahip olduğunda gerekli değildir
url_callbackÖdeme durumuna sahip Web Şeridi'nin hangi URL'si gönderilecek
to_currencyÖdemenin yapılacağı kripto para kodu. Para birimi parametresi Fiat olduğunda kullanılır. Aşağıdaki örneklere bakın
course_sourcestringMevcut DeğerlerBinanceBinanceP2pExmoKucoinSatıcı Ayarlarından DeğerFaturada dönüşüm için döviz kurlarının alındığı hizmet.Parametre yalnızca para birimi Fiat ise uygulanır, aksi takdirde varsayılan değer satıcının ayarlarından alınır.
from_currencystringnullPara çekme miktarını otomatik olarak dönüştürmeye ve FROM_Currency bakiyesini kullanmaya izin verir. Yalnızca USDT mevcuttur.
prioritystringmin: 4max: 11Mevcut DeğerlerrecommendedeconomyhighhighestrecommendedPara çekme önceliğini seçmek için parametre. Para çekme ücretinin maliyeti seçilen parametreye bağlıdır.Bu parametre yalnızca BTC, ETH, Polygon ve BSC ağlarının kullanılması durumunda uygulanır.
memostringmin: 1max: 30Belirli bir alıcı veya hedef belirlemek için kullanılan ton için ek tanımlayıcı

Parametre türü

string

Tanım

Ödeme tutarı

Parametre türü

string

Tanım

Ödeme için para birimi koduPara birimi ise fiat, to_currency parametresi gereklidir.

Parametre türü

stringmin:1max:100alpha_dash

Tanım

Sisteminizde Sipariş KimliğiParametre, alfabetik karakterler, sayılar, alt çizgiler ve çizgilerden oluşan bir dize olmalıdır. Herhangi bir alan veya özel karakter içermemelidir. order_id satıcı ödemeleri içinde benzersiz olmalı order_id ile mevcut bir ödeme bulduğumuzda, ayrıntılarını döndürürüz, yeni bir ödeme oluşturulmayacaktır.

Parametre türü

string

Tanım

Çekilmenin yapılacağı cüzdanın adresi

Parametre türü

boolean

Tanım

Para çekme ücretinin nereden düşüleceğini tanımlarDoğru - DengenizdenYanlış - Ödeme tutarından ödeme tutarı azalacak

Parametre türü

string

Tanım

Blockchain Ağ Kodu para birimi/to_currency bir kripto para birimi olduğunda ve örneğin BTC gibi yalnızca bir ağa sahip olduğunda gerekli değildir

Tanım

Ödeme durumuna sahip Web Şeridi'nin hangi URL'si gönderilecek

Tanım

Ödemenin yapılacağı kripto para kodu. Para birimi parametresi Fiat olduğunda kullanılır. Aşağıdaki örneklere bakın

Parametre türü

string
Mevcut Değerler
- Binance- BinanceP2p- Exmo- Kucoin

Tanım

Faturada dönüşüm için döviz kurlarının alındığı hizmet.Parametre yalnızca para birimi Fiat ise uygulanır, aksi takdirde varsayılan değer satıcının ayarlarından alınır.

Parametre türü

string

Tanım

Para çekme miktarını otomatik olarak dönüştürmeye ve FROM_Currency bakiyesini kullanmaya izin verir. Yalnızca USDT mevcuttur.

Parametre türü

stringmin: 4max: 11
Mevcut Değerler
- recommended- economy- high- highest

Tanım

Para çekme önceliğini seçmek için parametre. Para çekme ücretinin maliyeti seçilen parametreye bağlıdır.Bu parametre yalnızca BTC, ETH, Polygon ve BSC ağlarının kullanılması durumunda uygulanır.

Parametre türü

stringmin: 1max: 30

Tanım

Belirli bir alıcı veya hedef belirlemek için kullanılan ton için ek tanımlayıcı

* - zorunlu parametre

Talep Örneği


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

Cevap

Yanıt parametreleri

İsimTanım
uuidÖdemenin uuid
amountPara biriminde ödeme currency
currencyÖdeme için para birimi kodu
networkÖdemenin yapıldığı blockchain ağının kodu
addressÖdemenin yapıldığı cüzdanın adresi
txidBlockchain'de işlem kimliği
statusÖdeme durumu Mevcut tüm durumları görün
is_finalÖdemenin kesinleşip tamamlanmadığıÖdeme süreci, başarıyla ödendikten veya başarısız olduğunda sonuçlandırıldığı düşünülür. Ödeme hatası olması durumunda, fonlar bakiyenize iade edilecek ve ödeme işlemini tekrar başlatmanızı gerektirecektir.
balanceTüccar bakiyesinde kalan fonlar.
payer_currencyÖdemenin gerçekte yapılacağı kripto para kodu. Ödeme adresi ödeme para birimini alacaktır.
payer_amountÖdemenin payer_currency .

Tanım

Ödemenin uuid

Tanım

Para biriminde ödeme currency

Tanım

Ödeme için para birimi kodu

Tanım

Ödemenin yapıldığı blockchain ağının kodu

Tanım

Ödemenin yapıldığı cüzdanın adresi

Tanım

Blockchain'de işlem kimliği

Tanım

Ödeme durumu Mevcut tüm durumları görün

Tanım

Ödemenin kesinleşip tamamlanmadığıÖdeme süreci, başarıyla ödendikten veya başarısız olduğunda sonuçlandırıldığı düşünülür. Ödeme hatası olması durumunda, fonlar bakiyenize iade edilecek ve ödeme işlemini tekrar başlatmanızı gerektirecektir.

Tanım

Tüccar bakiyesinde kalan fonlar.

Tanım

Ödemenin gerçekte yapılacağı kripto para kodu. Ödeme adresi ödeme para birimini alacaktır.

Tanım

Ödemenin payer_currency .

Yanıt örneği


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
Kopya

Olası hatalar

Doğrulama hataları

kodlamak : 422

Örnek Yanıtlar:


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

Ödeme satıcı veya kullanıcınız için engellenirse, bu hata mesajını alırsınız. Bu, örneğin, şifrenizi değiştirdiğinizde ve ödemeler 24 saat boyunca engellendiğinde olur.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
Kopya

Para birimi parametresinde verdiğiniz para birimi kodunu desteklemezsek, bu hata mesajını alırsınız:


1{
2    "state": 1,
3    "message": "The currency was not found"
4}
Kopya

Ödeme yapmak için hizmeti bulamazsak, bu hata mesajını alacaksınız. Kripto para biriminin desteklendiğinden emin olmalısınız. Girilen değerlerin doğruluğunu kontrol edin. Para, ağ, from_currency, to_currency:


1{
2    "state": 1,
3    "message": "The service was not found"
4}
Kopya

Çekme miktarı çok küçükse, bu hata mesajını alacaksınız:


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

Ödemenin kripto para birimine sahip aktif bir satıcı cüzdanınız olmayacaksa, bu hatayı alacaksınız:


1{
2    "state": 1,
3    "message": "Wallet not found"
4}
Kopya

Tüm komisyonlar da dahil olmak üzere ödeme tutarı bakiyenizden daha fazlaysa, bu hata mesajını alacaksınız:


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

TO_Currency parametresinde aktarılan para biriminin ödeme hizmetini bulamazsak, bu hata mesajını alacaksınız:


1{
2    "state": 1,
3    "message": "Not found service to_currency"
4}
Kopya

TO_Currency'ye dönüşürken yanlışlıkla bir şey olursa, bu hata mesajını alırsınız:


1{
2    "state": 1,
3    "message": "Error convert to_currency"
4}
Kopya

Ödeme tutarı, kripto para birimi için desteklenen minimum miktardan azsa, bu hata mesajını alacaksınız:


1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}
Kopya

Ödeme tutarı, kripto para birimi için desteklenen maksimum miktardan fazlaysa, bu hata mesajını alacaksınız:


1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}
Kopya

Ödeme yapmak için yeterli fonunuz yoksa, bu hata mesajını alacaksınız:


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

Ödeme miktarını from_currency'den dönüştürmek için yeterli fonunuz yoksa, bu hata mesajını alacaksınız:


1{
2    "state": 1,
3    "message": "Not enough balance for convert USDT to LTC"
4}
Kopya

Teknik çalışma gerçekleşir ve ödeme geçici olarak kullanılamazsa, bu hata mesajını alacaksınız


1{
2    "state": 1,
3    "message": "The terminal was not found"
4}
Kopya

İç Sunucu Hatası

kodlamak : 500

Örnek Yanıtlar:


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