Operations (buy/sell/withdraw crypto)

Available operations

• Buying process

  • Getting token for buying

  • Buying

  • Confirmation of operation

  • Getting rate for buying

• Selling process

  • Getting token for selling

  • Selling

  • Getting rate for buying

• Withdrawal to another wallet

  • Currency converter

  • Withdrawal fees

  • Make a withdrawal

  • Withdrawal confirmation

Buying crypto

Buy object needs to be obtained first to start the process of buying:

Kotlin

val mercuryo: Mercuryo = Mercuryo.create(...)  
val buy: Buy = mercuryo.operations.buy

Swift

Getting token for buying

Before buying, you need to get a unique token designated to this specific operation, for this you can use the .convert method:

Kotlin

buy.convert(fromCurrency: String, toCurrency: String, amount: String) : ConverterResult

Swift

Buying

After you obtained a buying token you can call buy method passing parameters of operation.

Kotlin

buy.commit(cardId: String, cvv: String, buyToken: String, redirectUrl: String): TransactionStatus

Swift

Parameter	Description
cardId	ID of card in Mercuryo
cvv	CVV code of card
buyToken	Buying token buy.convert(...)
redirectUrl	URL where user will be redirected after operation. Example: http://my.mercuryo.io/orders?invoice={invoice_id}

Confirmation of operation

To finalize an operation user may need to confirm ownership of bank account by providing a descriptor sent as a part of transaction.

Kotlin

buy.verifyDescriptor(transactionId: String, code: String): TransactionStatus

Swift

Parameter	Description
transactionId	ID of transaction obtained after buy.commit(...)
code	Descriptor code

Getting rate for buying

User may want to know the rate of fiat-crypto conversion which may be obtained using the following method:

Kotlin

buy.rate(fromCurrency: String, toCurrency: String): Rate

Swift

Selling process

Sell object needs to be obtained first to start the process of buying:

Kotlin

val mercuryo: Mercuryo = Mercuryo.create(...)  
val sell: Sell = mercuryo.operations.sell

Swift

Getting token for selling

Before selling, you need to get a unique token designated to this specific operation, for this you can use the .convert method:

Kotlin

sell.convert(fromCurrency: String, toCurrency: String, amount: String) : ConverterResult

Swift

Selling

To sell you need to get token for selling first call method as shown below.

Kotlin

sell.commit(cardId: String, sellToken: String): TransactionStatus

Swift

Parameter	Description
cardId	ID of card in Mercuryo
sellToken	Token obtained from sell.convert(...)

Getting exchange rate for selling

Rate includes a fee.

Kotlin

sell.rate(fromCurrency: String, toCurrency: String): Rate

Swift

Withdrawal to another wallet

Withdraw object needs to be obtained first to start the process of buying:

Kotlin

val mercuryo: Mercuryo = Mercuryo.create(...)  
val withdraw: Withdraw = mercuryo.operations.withdraw

Swift

Currency converter

Before sending crypto it may be beneficial for user to know how amount converts to fiat or vice versa. Mercuryo SDK provides a method for that allowing to understand transaction better.

Kotlin

withdraw.convert(fromCurrency: String, toCurrency: String, amount: String) : ConverterResult

Swift

Withdrawal fees

To make withdrawal you need to obtain available blockchain fees first. In case there are no fees this method will throw an CurrencyNotSupportFeeException exception.

Kotlin

withdraw.getEstimateFee(currency: String, fiatCurrency: String, address: String, amount: String): EstimateWithdrawFee

Swift

Make a withdrawal

Kotlin

withdraw.commit(currency: String, address: String, amount: String, estimateId: String?): VerifyMetaData

Swift

Fields	Description
currency	Crypto
address	Wallet address
amount	Amount of withdrawal in crypto
estimateId	ID of estimation fee obtained on the previous step, see method withdraw.getEstimateFee

Withdrawal confirmation

User may need to confirm withdrawal using text message or email code.

Kotlin

withdraw.verify(next: VerifyMetaData.NextStep, key: String, code: String): TransactionStatus

Swift