Interne Überweisung zwischen eigenen Wallets erstellen

POST 
/api/withdrawal/internal-own

Erstellt eine interne Überweisung zwischen Wallets des Händlers und gibt die erstellte Transaktion zurück.

Anfrage

application/json

Body

Request-Bodyerforderlich

Daten zum Erstellen einer internen Überweisung zwischen eigenen Wallets.

srcWalletIdstringnullable
ID des Quell-Wallets.
Beispiel: USD880390848110
amountnumbererforderlich
Betrag.
Mögliche Werte: >= 0
Beispiel: 10.25
actionstringerforderlich
Aktion.
Mögliche Werte: [GIVE, GET]
Beispiel: GIVE
notestringnullable
Notiz.
Mögliche Werte: <= 255 Zeichen
Beispiel: Sandbox transfer note
srcCurrencystringnullable
Ausgangswährung.
Mögliche Werte: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Beispiel: USD
destWalletIdstringnullable
ID des Ziel-Wallets.
Beispiel: USD880390848110
destCurrencystringnullable
Zielwährung.
Mögliche Werte: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Beispiel: USD

Beispiel

{
  "srcWalletId": "USD880390848110",
  "amount": 10.25,
  "action": "GIVE",
  "note": "Sandbox transfer note",
  "srcCurrency": "USD",
  "destWalletId": "USD880390848110",
  "destCurrency": "USD"
}

Antworten

200

OK

application/json

Schema

Schema

transactionIduuid
Transaktions-ID.
Beispiel: 11111111-1111-4111-8111-111111111111
paymentMethodTypestring
Typ der Zahlungsmethode.
Mögliche Werte: [INTERNAL_OWN]
Beispiel: INTERNAL_OWN
transactionTypestring
Transaktionstyp.
Mögliche Werte: [INTERNAL_TRANSFER_OWN]
Beispiel: INTERNAL_TRANSFER_OWN
statusstring
Status.
Mögliche Werte: [PENDING, COMPLETED, CANCELED, REFUNDED]
Beispiel: COMPLETED
directionstring
Richtung.
Mögliche Werte: [DEPOSIT, WITHDRAWAL]
Beispiel: DEPOSIT
transactionDirectionstring
Richtung der Transaktion.
Mögliche Werte: [INCOMING, OUTGOING, EXCHANGE]
Beispiel: OUTGOING
currencystring
Währung.
Mögliche Werte: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Beispiel: USD
amountnumber
Betrag.
Beispiel: 10.25
createdAtdate-time

Erstellungszeitpunkt.

paymentScopestring
Zahlungsbereich.
Mögliche Werte: [MERCHANT_API]
Beispiel: MERCHANT_API
orderIdstring
Bestell-ID.
Beispiel: ORDER_123456
walletSrcIdstring
ID des Quell-Wallets.
Beispiel: USD880390848110
walletDestIdstring
ID des Ziel-Wallets.
Beispiel: USD880390848110
fullCommissionnumber
Gesamtgebühr.
Beispiel: 10.25
commentstring
Kommentar.
Beispiel: Sandbox transfer note
cryptoCurrencyTxHashstring
Hash der Krypto-Transaktion.
Beispiel: 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e
completedAtdate-time

Abschlusszeitpunkt.

Beispiel

{
  "transactionId": "11111111-1111-4111-8111-111111111111",
  "paymentMethodType": "INTERNAL_OWN",
  "transactionType": "INTERNAL_TRANSFER_OWN",
  "status": "CREATED",
  "direction": "WITHDRAWAL",
  "transactionDirection": "EXCHANGE",
  "currency": "USD",
  "amount": 10.25,
  "createdAt": "2026-01-15T10:30:00",
  "paymentScope": "MERCHANT_API",
  "orderId": "ORDER_123456",
  "walletSrcId": "USD880390848110",
  "walletDestId": "USD880390848110",
  "fullCommission": 10.25,
  "comment": "Sandbox transfer note",
  "cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
  "completedAt": "2026-01-15T10:30:00"
}

400

Ungültige Anfrage. Die Anfrage ist fehlerhaft oder enthält ungültige Parameter.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: disabled
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: FORM
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

Nicht autorisiert. Die Authentifizierungs-Header des Händlers fehlen oder sind ungültig.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: userDoesNotExistException
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

Nicht gefunden. Die angeforderte Ressource existiert nicht.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: resourceNotFound
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: Resource not found
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Interner Serverfehler. Unerwarteter Fehler, wenden Sie sich an den Support

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: internalServerError
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: Internal server error
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}