curl --request POST \
  --url https://whitebit.com/api/v4/main-account/fiat-deposit-url \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "ticker": "UAH",
  "provider": "VISAMASTER",
  "amount": "100",
  "uniqueId": "{{generateID}}",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'

{
  "url": "https://someaddress.com"
}

Main Balance

Get fiat deposit address

This endpoint retrieves a deposit url of the fiat invoice.

Please, pay attention that this endpoint works on demand. It means that you need to contact WhiteBIT support and provide your API key to get access to this functionality.

Errors

{
  "code": 0,
  "message": "Validation failed",
  "errors": {
    "ticker": ["The ticker field is required."],
    "provider": ["The provider field is required."]
  }
}

{
  "code": 0,
  "message": "Validation failed",
  "errors": {
    "amount": ["Current limit exceeded"]
  }
}

If you have used VISAMASTER as provider, you must pass referer header when you go to the invoice link (for example, pass referer header when you go to https://someaddress.com). Otherwise if there is no header (for example, you go to https://someaddress.com from Telegram message) you will be redirected to the WhiteBIT homepage

Rate limit: 1000 requests/10 sec.

Response is cached for: NONE

POST

api

main-account

fiat-deposit-url

curl --request POST \
  --url https://whitebit.com/api/v4/main-account/fiat-deposit-url \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "ticker": "UAH",
  "provider": "VISAMASTER",
  "amount": "100",
  "uniqueId": "{{generateID}}",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'

{
  "url": "https://someaddress.com"
}

Authorizations

X-TXC-APIKEY

string

header

required

API key authentication using signed requests

Body

application/json

ticker

string

required

Currency's ticker (fiat). ⚠️ Currencies ticker should be fiat and has "can_deposit" status must be "true". Use Asset Status endpoint to know more about currency.

Example:

"UAH"

provider

string

required

Fiat currency provider. ⚠️ Currency provider should be taken from Asset Status endpoint response.

Example:

"VISAMASTER"

amount

string

required

Deposit amount

Example:

"100"

uniqueId

string

required

Unique transaction identifier on client's side

request

string

required

Request signature

nonce

string

required

Unique request identifier

customer

object

Customer information (required for USD/EUR with VISAMASTER provider)

Show child attributes

successLink

string

Customer will be redirected to this URL by acquiring provider after success deposit. To activate this feature, please contact support

failureLink

string

Customer will be redirected to this URL in case of fail or rejection on acquiring provider side. To activate this feature, please contact support

returnLink

string

Customer will be redirected to the URL defined if selects 'back' option after from the payment success or failure page. To activate this feature, define desired link. If not populated, option 'back' won't be displayed

Response

Successful response

url

string

Address for deposit

Get cryptocurrency deposit address Issue JWT token

⌘I