Kendi cüzdanlarınız arasında iç transfer oluşturma

POST 
/api/withdrawal/internal-own

Üye işyerinin cüzdanları arasında iç transfer oluşturur ve oluşturulan işlemi döndürür.

İstek

application/json

Body

İstek gövdesizorunlu

Kendi cüzdanlarınız arasında iç transfer oluşturma verileri.

srcWalletIdstringnullable
Kaynak cüzdan ID’si.
Örnek: USD880390848110
amountnumberzorunlu
Tutar.
Olası değerler: >= 0
Örnek: 10.25
actionstringzorunlu
İşlem.
Olası değerler: [GIVE, GET]
Örnek: GIVE
notestringnullable
Not.
Olası değerler: <= 255 karakter
Örnek: Sandbox transfer note
srcCurrencystringnullable
Kaynak para birimi.
Olası değerler: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Örnek: USD
destWalletIdstringnullable
Hedef cüzdan ID’si.
Örnek: USD880390848110
destCurrencystringnullable
Hedef para birimi.
Olası değerler: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Örnek: USD

Örnek

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

Yanıtlar

200

OK

application/json

Şema

Şema

transactionIduuid
İşlem ID’si.
Örnek: 11111111-1111-4111-8111-111111111111
paymentMethodTypestring
Ödeme yöntemi türü.
Olası değerler: [INTERNAL_OWN]
Örnek: INTERNAL_OWN
transactionTypestring
İşlem türü.
Olası değerler: [INTERNAL_TRANSFER_OWN]
Örnek: INTERNAL_TRANSFER_OWN
statusstring
Durum.
Olası değerler: [PENDING, COMPLETED, CANCELED, REFUNDED]
Örnek: COMPLETED
directionstring
Yön.
Olası değerler: [DEPOSIT, WITHDRAWAL]
Örnek: DEPOSIT
transactionDirectionstring
İşlem yönü.
Olası değerler: [INCOMING, OUTGOING, EXCHANGE]
Örnek: OUTGOING
currencystring
Para birimi.
Olası değerler: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Örnek: USD
amountnumber
Tutar.
Örnek: 10.25
createdAtdate-time

Oluşturulma zamanı.

paymentScopestring
Ödeme kapsamı.
Olası değerler: [MERCHANT_API]
Örnek: MERCHANT_API
orderIdstring
Sipariş ID’si.
Örnek: ORDER_123456
walletSrcIdstring
Kaynak cüzdan ID’si.
Örnek: USD880390848110
walletDestIdstring
Hedef cüzdan ID’si.
Örnek: USD880390848110
fullCommissionnumber
Toplam komisyon.
Örnek: 10.25
commentstring
Yorum.
Örnek: Sandbox transfer note
cryptoCurrencyTxHashstring
Kripto işlem hash’i.
Örnek: 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e
completedAtdate-time

Tamamlanma zamanı.

Örnek

{
  "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

Hatalı istek. İstek hatalı biçimlendirilmiş veya geçersiz parametreler içeriyor.

application/json

Şema

Şema

statusstringzorunlu
Yanıt durumu.
Olası değerler: [error]
Örnek: error
data objectzorunlu
Hata yanıtı verileri.
errors object[]zorunlu
İstek için döndürülen hataların listesi.
Array [
errorMessagestringzorunlu
Değişmeyen, makine tarafından okunabilir hata kodu.
Örnek: disabled
errorTypestringzorunlu
Hata kategorisi.
Örnek: FORM
errorIdstringzorunlu
Destek ve günlükler için kısa, benzersiz hata tanımlayıcısı.
Örnek: errTest1234
errorDescriptionstringzorunlu
Okunabilir hata açıklaması.
Örnek: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Varsa hatayla ilgili istek alanı.
Örnek: null
paramsobject[]zorunlu
Ek hata parametreleri.
requestParamsobjectzorunlu
Tanılama için kaydedilen istek parametreleri.
]

Örnek

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

401

Yetkisiz. Üye işyeri kimlik doğrulama başlıkları eksik veya geçersiz.

application/json

Şema

Şema

statusstringzorunlu
Yanıt durumu.
Olası değerler: [error]
Örnek: error
data objectzorunlu
Hata yanıtı verileri.
errors object[]zorunlu
İstek için döndürülen hataların listesi.
Array [
errorMessagestringzorunlu
Değişmeyen, makine tarafından okunabilir hata kodu.
Örnek: userDoesNotExistException
errorTypestringzorunlu
Hata kategorisi.
Örnek: GENERAL
errorIdstringzorunlu
Destek ve günlükler için kısa, benzersiz hata tanımlayıcısı.
Örnek: errTest1234
errorDescriptionstringzorunlu
Okunabilir hata açıklaması.
Örnek: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Varsa hatayla ilgili istek alanı.
Örnek: null
paramsobject[]zorunlu
Ek hata parametreleri.
requestParamsobjectzorunlu
Tanılama için kaydedilen istek parametreleri.
]

Örnek

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

404

Bulunamadı. İstenen kaynak mevcut değil.

application/json

Şema

Şema

statusstringzorunlu
Yanıt durumu.
Olası değerler: [error]
Örnek: error
data objectzorunlu
Hata yanıtı verileri.
errors object[]zorunlu
İstek için döndürülen hataların listesi.
Array [
errorMessagestringzorunlu
Değişmeyen, makine tarafından okunabilir hata kodu.
Örnek: resourceNotFound
errorTypestringzorunlu
Hata kategorisi.
Örnek: GENERAL
errorIdstringzorunlu
Destek ve günlükler için kısa, benzersiz hata tanımlayıcısı.
Örnek: errTest1234
errorDescriptionstringzorunlu
Okunabilir hata açıklaması.
Örnek: Resource not found
errorFieldstringnullable
Varsa hatayla ilgili istek alanı.
Örnek: null
paramsobject[]zorunlu
Ek hata parametreleri.
requestParamsobjectzorunlu
Tanılama için kaydedilen istek parametreleri.
]

Örnek

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

500

Sunucu iç hatası. Beklenmeyen hata, lütfen destek ekibiyle iletişime geçin

application/json

Şema

Şema

statusstringzorunlu
Yanıt durumu.
Olası değerler: [error]
Örnek: error
data objectzorunlu
Hata yanıtı verileri.
errors object[]zorunlu
İstek için döndürülen hataların listesi.
Array [
errorMessagestringzorunlu
Değişmeyen, makine tarafından okunabilir hata kodu.
Örnek: internalServerError
errorTypestringzorunlu
Hata kategorisi.
Örnek: GENERAL
errorIdstringzorunlu
Destek ve günlükler için kısa, benzersiz hata tanımlayıcısı.
Örnek: errTest1234
errorDescriptionstringzorunlu
Okunabilir hata açıklaması.
Örnek: Internal server error
errorFieldstringnullable
Varsa hatayla ilgili istek alanı.
Örnek: null
paramsobject[]zorunlu
Ek hata parametreleri.
requestParamsobjectzorunlu
Tanılama için kaydedilen istek parametreleri.
]

Örnek

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