Eine Auszahlung erstellen

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

Die Auszahlungen über API werden nur aus Ihren Geschäftsbrieftaschenbilanzen getätigt.

Auszahlungen können auf unterschiedliche Weise getätigt werden:

  1. Sie können die Auszahlung in einer bestimmten Kryptowährung erhalten, und die Auszahlung wird dann automatisch in dieser spezifischen Kryptowährung verarbeitet. Stellen Sie dazu sicher, dass Sie in dieser bestimmten Währung über einen ausreichenden Restbetrag verfügen, um alle damit verbundenen Gebühren zu decken.
  2. Alternativ haben Sie die Möglichkeit, den Auszahlungsbetrag in einer Fiat -Währung anzugeben. In diesem Fall wird der Betrag automatisch in eine bestimmte Kryptowährung aus Ihrem verfügbaren Saldo konvertiert. Wenn Sie beispielsweise eine Auszahlung von 20 USD in LTC anfordern, wird der äquivalente Wert von Ihrem LTC -Saldo abgezogen. Es ist wichtig, genügend Mittel in der entsprechenden Kryptowährung zu haben, um alle anwendbaren Gebühren zu decken.
  3. Eine andere Möglichkeit besteht darin, den Auszahlungsbetrag in einer Fiat -Währung anzugeben, die automatisch mit Ihrem USDT -Saldo in eine bestimmte Kryptowährung umgewandelt wird. Diese Option ist besonders nützlich, wenn Sie automatisch aktiviert sind, da Fonds aus Ihren Rechnungen automatisch in USDT konvertiert werden. Wenn Sie beispielsweise eine Auszahlung von 20 USD in LTC vornehmen möchten, aber nur einen Restbetrag in USDT haben, stellen Sie sicher, dass Sie über ausreichende USDT -Mittel verfügen, um alle Gebühren zu decken.
  4. Darüber hinaus können Sie den Auszahlungsbetrag in jeder Kryptowährung Ihrer Präferenz angeben. Die Auszahlung wird dann in dieser spezifischen Kryptowährung automatisch verarbeitet, wobei der verfügbare USDT -Saldo verwendet wird. Es ist entscheidend, genügend USDT -Gleichgewicht zu haben, um alle damit verbundenen Gebühren abzudecken.

Anfrage

Abfrageparameter

NameParametertypStandardwertDefinition
amount*stringAuszahlungsbetrag
currency*stringWährungscode für die AuszahlungWenn Währung bei Fiat, ist der Parameter to_currency erforderlich .
order_id*stringmin:1max:100alpha_dashBestell -ID in Ihrem System bestellenDer Parameter sollte eine Zeichenfolge sein, die aus alphabetischen Zeichen, Zahlen, Unterstrichen und Strichen besteht. Es sollte keine Räume oder Sonderzeichen enthalten.Die order_id muss innerhalb der Händlerauszahlungen eindeutig seinWenn wir eine vorhandene Auszahlung mit order_id finden, geben wir ihre Details zurück, eine neue Auszahlung wird nicht erstellt.
address*stringDie Adresse der Brieftasche, zu der die Auszahlung erfolgt
is_subtract*booleanDefiniert, wo die Auszahlungsgebühr abgezogen wirdwahr - aus deinem GleichgewichtFalsch - Aus dem Auszahlungsbetrag wird der Auszahlungsbetrag verringert
network*stringBlockchain -NetzwerkcodeNicht erforderlich, wenn die Währung/to_currency eine Kryptowährung ist und nur ein Netzwerk hat, z. B. BTC
url_callbackURL, an die Webhooks mit Auszahlungsstatus gesendet werden
to_currencyKryptowährungscode, in dem die Auszahlung erfolgt. Es wird verwendet, wenn der Parameter currency fiat ist. Siehe Beispiele unten
course_sourcestringVerfügbare WerteBinanceBinanceP2pExmoKucoinWert aus den Einstellungen des HändlersDer Service, aus dem die Wechselkurse zur Konvertierung in der Rechnung angenommen werden.Der Parameter wird nur angewendet, wenn die Währung fiat ist, andernfalls wird der Standardwert aus den Einstellungen des Händlers entnommen.
from_currencystringnullErmöglicht die automatische Umwandlung des Auszahlungsbetrags und die Verwendung des Ausgleichens von _currency. Nur USDT ist verfügbar.
prioritystringmin: 4max: 11Verfügbare WerterecommendedeconomyhighhighestrecommendedDer Parameter zur Auswahl der Auszahlungspriorität. Die Höhe der Abhebungsgebühr hängt vom gewählten Parameter ab.Dieser Parameter wird nur bei der Verwendung der Netzwerke BTC, ETH, Polygon und BSC angewendet.
memostringmin: 1max: 30Zusätzliche Kennung für TON, verwendet, um einen bestimmten Empfänger oder ein bestimmtes Ziel anzugeben

Parametertyp

string

Definition

Auszahlungsbetrag

Parametertyp

string

Definition

Währungscode für die AuszahlungWenn Währung bei Fiat, ist der Parameter to_currency erforderlich .

Parametertyp

stringmin:1max:100alpha_dash

Definition

Bestell -ID in Ihrem System bestellenDer Parameter sollte eine Zeichenfolge sein, die aus alphabetischen Zeichen, Zahlen, Unterstrichen und Strichen besteht. Es sollte keine Räume oder Sonderzeichen enthalten.Die order_id muss innerhalb der Händlerauszahlungen eindeutig seinWenn wir eine vorhandene Auszahlung mit order_id finden, geben wir ihre Details zurück, eine neue Auszahlung wird nicht erstellt.

Parametertyp

string

Definition

Die Adresse der Brieftasche, zu der die Auszahlung erfolgt

Parametertyp

boolean

Definition

Definiert, wo die Auszahlungsgebühr abgezogen wirdwahr - aus deinem GleichgewichtFalsch - Aus dem Auszahlungsbetrag wird der Auszahlungsbetrag verringert

Parametertyp

string

Definition

Blockchain -NetzwerkcodeNicht erforderlich, wenn die Währung/to_currency eine Kryptowährung ist und nur ein Netzwerk hat, z. B. BTC

Definition

URL, an die Webhooks mit Auszahlungsstatus gesendet werden

Definition

Kryptowährungscode, in dem die Auszahlung erfolgt. Es wird verwendet, wenn der Parameter currency fiat ist. Siehe Beispiele unten

Parametertyp

string
Verfügbare Werte
- Binance- BinanceP2p- Exmo- Kucoin

Definition

Der Service, aus dem die Wechselkurse zur Konvertierung in der Rechnung angenommen werden.Der Parameter wird nur angewendet, wenn die Währung fiat ist, andernfalls wird der Standardwert aus den Einstellungen des Händlers entnommen.

Parametertyp

string

Definition

Ermöglicht die automatische Umwandlung des Auszahlungsbetrags und die Verwendung des Ausgleichens von _currency. Nur USDT ist verfügbar.

Parametertyp

stringmin: 4max: 11
Verfügbare Werte
- recommended- economy- high- highest

Definition

Der Parameter zur Auswahl der Auszahlungspriorität. Die Höhe der Abhebungsgebühr hängt vom gewählten Parameter ab.Dieser Parameter wird nur bei der Verwendung der Netzwerke BTC, ETH, Polygon und BSC angewendet.

Parametertyp

stringmin: 1max: 30

Definition

Zusätzliche Kennung für TON, verwendet, um einen bestimmten Empfänger oder ein bestimmtes Ziel anzugeben

* - obligatorischer Parameter

Beispiel anfordern


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

Antwort

Antwortparameter

NameDefinition
uuiduuid der Zahlung
amountAuszahlungsbetrag in currency
currencyWährungscode für die Auszahlung
networkDer Code des Blockchain -Netzwerks, in dem die Zahlung erfolgt
addressDie Adresse der Brieftasche, zu der die Zahlung geleistet wird
txidTransaktions -ID in der Blockchain
statusAuszahlungsstatus Sehen Sie alle verfügbaren Status
is_finalOb die Auszahlung abgeschlossen istDer Ausschüttungsprozess wird als endgültig angesehen, sobald er erfolgreich bezahlt wurde oder wenn er fehlgeschlagen ist. Im Falle eines Ausschüttungsfehlers werden die Mittel in Ihren Guthaben zurückgegeben, sodass Sie den Ausschüttungsvorgang erneut einleiten müssen.
balanceDie verbleibenden Mittel für das Gleichgewicht des Händlers.
payer_currencyKryptowährungscode, in dem die Auszahlung tatsächlich getätigt wird. Die Auszahlungsadresse erhält die Auszahlungswährung.
payer_amountBetrag in payer_currency der Auszahlung.

Definition

uuid der Zahlung

Definition

Auszahlungsbetrag in currency

Definition

Währungscode für die Auszahlung

Definition

Der Code des Blockchain -Netzwerks, in dem die Zahlung erfolgt

Definition

Die Adresse der Brieftasche, zu der die Zahlung geleistet wird

Definition

Transaktions -ID in der Blockchain

Definition

Auszahlungsstatus Sehen Sie alle verfügbaren Status

Definition

Ob die Auszahlung abgeschlossen istDer Ausschüttungsprozess wird als endgültig angesehen, sobald er erfolgreich bezahlt wurde oder wenn er fehlgeschlagen ist. Im Falle eines Ausschüttungsfehlers werden die Mittel in Ihren Guthaben zurückgegeben, sodass Sie den Ausschüttungsvorgang erneut einleiten müssen.

Definition

Die verbleibenden Mittel für das Gleichgewicht des Händlers.

Definition

Kryptowährungscode, in dem die Auszahlung tatsächlich getätigt wird. Die Auszahlungsadresse erhält die Auszahlungswährung.

Definition

Betrag in payer_currency der Auszahlung.

Antwortbeispiel


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
KOPIEREN

Mögliche Fehler

Validierungsfehler

Code : 422

Beispielantworten:


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

Wenn die Auszahlung auf Ihrem Händler oder Benutzer blockiert ist, erhalten Sie diese Fehlermeldung. Dies geschieht beispielsweise, wenn Sie Ihr Passwort ändern und die Auszahlungen 24 Stunden lang blockiert werden.


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

Wenn wir den Währungscode, den Sie im Währungsparameter angegeben haben, nicht unterstützen, erhalten Sie diese Fehlermeldung:


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

Wenn wir den Dienst für die Ausführung der Auszahlung nicht finden können, erhalten Sie diese Fehlermeldung. Sie müssen sicherstellen, dass die Kryptowährung unterstützt wird. Überprüfen Sie die Richtigkeit der eingegebenen Werte in. Währung, Netzwerk, von der Kurswährung, to_currency:


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

Wenn der Auszahlungsbetrag zu klein ist, erhalten Sie diese Fehlermeldung:


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

Wenn Sie keine aktive Händler -Brieftasche mit einer Kryptowährung der Auszahlung haben, erhalten Sie diesen Fehler:


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

Wenn der Auszahlungsbetrag, einschließlich aller Provisionen, mehr als Ihr Guthaben ist, erhalten Sie diese Fehlermeldung:


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

Wenn wir den Auszahlungsdienst der Währung nicht finden, die in Parameter für die Erschreibung von Währungen übergeben wurde, erhalten Sie diese Fehlermeldung:


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

Wenn bei der Konvertierung in to_currency versehentlich etwas passiert, erhalten Sie diese Fehlermeldung:


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

Wenn der Auszahlungsbetrag unter dem minimal unterstützten Betrag für die Kryptowährung beträgt, erhalten Sie diese Fehlermeldung:


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

Wenn der Auszahlungsbetrag größer als der maximal unterstützte Betrag für die Kryptowährung ist, erhalten Sie diese Fehlermeldung:


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

Wenn Sie nicht über genügend Mittel verfügen, um eine Auszahlung vorzunehmen, erhalten Sie diese Fehlermeldung:


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

Wenn Sie nicht über genügend Mittel verfügen, um den Auszahlungsbetrag von von _currency zu konvertieren, erhalten Sie diese Fehlermeldung:


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

Wenn technische Arbeiten erfolgen und die Auszahlung vorübergehend nicht verfügbar ist, erhalten Sie diese Fehlermeldung


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

Interner Serverfehler

Code : 500

Beispielantworten:


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