Skip to main content

API Reference

  • Updated

General information

API endpoint for all requests:

https://app.wllxpay.io/api/v2

 

Deposit flow

  1. You obtain new address from WallexPay API and store it somewhere on your side. After that you show this address to your customer in order to make a deposit.
  2. Customer sends some funds to this address.
  3. When transaction is sent by a customer - WallexPay sends a callback to your callback URL with transaction details. It contains status, address, currency, amount and fees. If status is successful, you should deposit respective amount to customer balance on your side.

 

Withdrawal flow

  1. You request to send amount of money to address.
  2. Your request is validated on our side. If signature is correct, address is valid and you have enough balance - WallexPay responds you with the transaction object.
  3. You will receive a callback when transaction status is updated.

Deposit with exchange flow

You don't want to touch or store cryptocurrency, but only use it as a payment method. Your customer deposits BTC, WallexPay instantly converts it to EUR so that you would receive EUR on your WallexPay account.

  1. You obtain new address from the WallexPay API same as in deposit flow, but additionally pass another parameter "convert_to" in your request specifying resulting currency.
  2. When new deposit is arriving, WallexPay converts all arriving funds to destination funds, and sends notifications as in regular deposit

Withdrawal with exchange flow

You wish to send Cryptocurrency from your Fiat currency balance. For example you want to send EUR amount but your customer receives money in BTC.

  1. You do exactly same as in withdrawals, but you specify 2 currencies. One is a currency of your sending balance and Second is a cryptocurrency your Customer wishes to receive.
  2. Your request is validated on our side. If signature is correct, address is valid and you have enough balance - WallexPay responds you with the transaction object.
  3. You will receive a callback when transaction status is updated.

Futures flow

In order to guarantee receiving amount, rates should be fixed.

  1. You send address for exchange (If it is not necessary to receive exchange rates you can skip this step)
  2. You receive rates and their fixation time
  3. To confirm futures You have to send exchange pair and amount due.
  4. When new deposit is arriving, WallexPay converts all arriving funds to destination funds, and sends notifications as in regular deposit.

In case if received and sent amounts don't equal, WallexPay converts it like normal deposit with exchange.

Limit for this operation is 10 000 EUR.

Invoice flow

Invoices allow to conduct deposits with a fixed rate within a limited period of time disregarding the exchange rate fluctuations. In case it’s necessary to convert funds in fiat currency or convert it to another crypto currency this option will allow to visualize the exact amount of a sender’s currency required to receive the exact amount in a receiver’s currency. When a deposit is processed through this flow, a user is being redirected to the respective Invoice page via the preset link and just needs to follow instructions specified on it. It also allows to conduct refunds in case a user fails to manage to deposit within an established timeframe or discovers non-sufficient balance. All is required in that case is to follow the link with the respective instructions sent to an e-mail of a customer.