⚠️ Special Note

Some API errors worth our partner's attention and other stuff

There are a few things we would like you to take consideration into. Please check the followings.

LP Quote Maintenance

Although Wello is dedicated to stable quote and order flow. However, there are times when our liquidity providers (LP), who offer our users crypto quotes, are under maintenance. Some are regular maintenance, however, sometimes we may have irregular maintenance from LPs.

Whenever this happen, you wouldn't be able to successfully get quotes from us and receive 500 failed operation status which conveys the message below (You may check all possible failures in requesting Quote API):

{
  "code": "OCBS_TRADING_PAIR_UNDER_MAINTENANCE",
  "message": "Buying and selling this cryptocurrency will resume soon",
  "messageDetail": null,
  "data": null,
  "success": false
}

We recommend you to hide Wello entrance when you receive this error message so you can provide your users best experience. Wello is working on making sure the quote service as stable as possible, so in the future, you will no longer receive this message.

Wallet Address Required for Place Order API

Applied only to certain partners

Most partners (especially providing wallet services directly to users) will not be required to pass wallet addresses. However, for some partners, Wello will require you to provide wallet addresses when you place order for users. When that happens, Wello will tell you if you are applicable to this case and you will also get this error when placing order through /order/place/v1 API:

{
  "code": "WALLET_ADDRESS_REQUIRED",
  "message": "Please pass us your wallet addresses to generate checkout url.",
  "messageDetail": null,
  "data": null,
  "success": false
}

Cryptos wallet address memo/tag

Currently, we only support cryptos that do not require memo/tag. If you are hoping to have cryptos that can transfer with tag/memo, please wait patiently until we are able to support this for you.

At present, we only support BSC(BEP20), ETH, BTC, Polygon chains. Cryptos from these chains don't require memo/tag. If you have memo requirement on your platform, we would recommend you to pass us the addresses only with chains that don't require memo/tag, especially for Buy orders.