Eine Auszahlung erstellen
Die Auszahlungen über API werden nur aus Ihren Geschäftsbrieftaschenbilanzen getätigt.
Auszahlungen können auf unterschiedliche Weise getätigt werden:
- 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.
- 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.
- 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.
- 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
Name | Parametertyp | Standardwert | Definition |
---|---|---|---|
amount* | string | Auszahlungsbetrag | |
currency* | string | Währungscode für die AuszahlungWenn Währung bei Fiat, ist der Parameter to_currency erforderlich . | |
order_id* | stringmin:1max:100alpha_dash | 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. | |
address* | string | Die Adresse der Brieftasche, zu der die Auszahlung erfolgt | |
is_subtract* | boolean | Definiert, wo die Auszahlungsgebühr abgezogen wirdwahr - aus deinem GleichgewichtFalsch - Aus dem Auszahlungsbetrag wird der Auszahlungsbetrag verringert | |
network* | string | Blockchain -NetzwerkcodeNicht erforderlich, wenn die Währung/to_currency eine Kryptowährung ist und nur ein Netzwerk hat, z. B. BTC | |
url_callback | URL, an die Webhooks mit Auszahlungsstatus gesendet werden | ||
to_currency | Kryptowährungscode, in dem die Auszahlung erfolgt. Es wird verwendet, wenn der Parameter currency fiat ist. Siehe Beispiele unten | ||
course_source | stringVerfügbare Werte• Binance• BinanceP2p• Exmo• Kucoin | Wert aus den Einstellungen des Händlers | 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. |
from_currency | string | null | Ermöglicht die automatische Umwandlung des Auszahlungsbetrags und die Verwendung des Ausgleichens von _currency. Nur USDT ist verfügbar. |
priority | stringmin: 4max: 11Verfügbare Werte• recommended• economy• high• highest | recommended | 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. |
memo | stringmin: 1max: 30 | Zusätzliche Kennung für TON, verwendet, um einen bestimmten Empfänger oder ein bestimmtes Ziel anzugeben |
Parametertyp
stringDefinition
AuszahlungsbetragParametertyp
stringDefinition
Währungscode für die AuszahlungWenn Währung bei Fiat, ist der Parameter to_currency erforderlich .Parametertyp
stringmin:1max:100alpha_dashDefinition
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
stringDefinition
Die Adresse der Brieftasche, zu der die Auszahlung erfolgtParametertyp
booleanDefinition
Definiert, wo die Auszahlungsgebühr abgezogen wirdwahr - aus deinem GleichgewichtFalsch - Aus dem Auszahlungsbetrag wird der Auszahlungsbetrag verringertParametertyp
stringDefinition
Blockchain -NetzwerkcodeNicht erforderlich, wenn die Währung/to_currency eine Kryptowährung ist und nur ein Netzwerk hat, z. B. BTCDefinition
URL, an die Webhooks mit Auszahlungsstatus gesendet werdenDefinition
Kryptowährungscode, in dem die Auszahlung erfolgt. Es wird verwendet, wenn der Parameter currency fiat ist. Siehe Beispiele untenParametertyp
string
Verfügbare Werte- Binance- BinanceP2p- Exmo- KucoinDefinition
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
stringDefinition
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- highestDefinition
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: 30Definition
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",
}'
KOPIERENAntwort
Antwortparameter
Name | Definition |
---|---|
uuid | uuid der Zahlung |
amount | Auszahlungsbetrag in currency |
currency | Währungscode für die Auszahlung |
network | Der Code des Blockchain -Netzwerks, in dem die Zahlung erfolgt |
address | Die Adresse der Brieftasche, zu der die Zahlung geleistet wird |
txid | Transaktions -ID in der Blockchain |
status | Auszahlungsstatus Sehen Sie alle verfügbaren Status |
is_final | 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. |
balance | Die verbleibenden Mittel für das Gleichgewicht des Händlers. |
payer_currency | Kryptowährungscode, in dem die Auszahlung tatsächlich getätigt wird. Die Auszahlungsadresse erhält die Auszahlungswährung. |
payer_amount | Betrag in payer_currency der Auszahlung. |
Definition
uuid der ZahlungDefinition
Auszahlungsbetrag in currencyDefinition
Währungscode für die AuszahlungDefinition
Der Code des Blockchain -Netzwerks, in dem die Zahlung erfolgtDefinition
Die Adresse der Brieftasche, zu der die Zahlung geleistet wirdDefinition
Transaktions -ID in der BlockchainDefinition
Auszahlungsstatus Sehen Sie alle verfügbaren StatusDefinition
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
KOPIERENMögliche Fehler
Validierungsfehler
Code : 422
Beispielantworten:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn der Auszahlungsbetrag zu klein ist, erhalten Sie diese Fehlermeldung:
1{
2 "state": 1,
3 "message": "The withdrawal amount is too small"
4}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn bei der Konvertierung in to_currency versehentlich etwas passiert, erhalten Sie diese Fehlermeldung:
1{
2 "state": 1,
3 "message": "Error convert to_currency"
4}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENWenn 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}
KOPIERENInterner Serverfehler
Code : 500
Beispielantworten:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}
KOPIEREN