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

var mercuryoSDK: IMercuryo = IMercuryo(isDebug: true, baseHost: "HOST_HERE")
var wallet = mercuryoSDK.operations.buy

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

var token: String?

buy.convert(fromCurrency: "BTC", toCurrency: "EUR", amount: "1") { converterResult, error in 
    token = converterResult?.token
    //do some magic here
}

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

var transactionID: String?

buy.commit(cardId: "CARD_ID HERE", cvv: "CARD_CVV HERE", buyToken: token, redirectUrl: "REDIRECT_URL HERE") { transactionStatus, error in 
    transactionID = transactionStatus?.id
    //do some magic here
}

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

buy.verifyDescriptor(transactionId: transactionID, code: "TRANSACTION_CODE HERE") { transactionStatus, error in 
    //do some magic here
}

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

buy.getRate(fromCurrency: "BTC", toCurrency: "EUR") { rate, error in 
    //do soma magic here
}

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

var mercuryoSDK: IMercuryo = IMercuryo(isDebug: true, baseHost: "HOST_HERE")
var wallet = mercuryoSDK.operations.sell

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

var token: String?

sell.convert(fromCurrency: "BTC", toCurrency: "EUR", amount: "1") { converterResult, error in 
    token = converterResult?.token
    //do some magic here
}

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

sell.commit(cardId: "CARD_ID HERE", sellToken: token) { transactionStatus, error in 
    //do some magic here
}

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

sell.getRate(fromCurrency: "BTC", toCurrency: "EUR") { rate, error in 
    //do soma magic here
}

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

var mercuryoSDK: IMercuryo = IMercuryo(isDebug: true, baseHost: "HOST_HERE")
var wallet = mercuryoSDK.operations.buy

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

var token: String?

withdraw.convert(fromCurrency: "BTC", toCurrency: "EUR", amount: "1") { converterResult, error in 
    token = converterResult?.token
    //do some magic here
}

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

var firstEstimateId: String?
withdraw.getEstimateFee(currency: "BTC", fiatCurrency: "EUR", address: "ADDRESS HERE", amount: "1") { fee, error in 
    firstEstimateId = fee?.fees.first?.id
    //do soma magic here
}

Make a withdrawal

Kotlin

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

Swift

var nextStep: VerifyMetaData.NextStep?
var key: String?

withdraw.commit(currency: "BTC", address: "ADDRESS HERE", amount: "1", estimateId: firstEstimateId) { verifyData, error in 
    nextStep = verifyData?.step
    key = verifyData?.key
    //do some magic here
}

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

withdraw.verify(next: nextStep, key: key, code: "SMS/EMAIL CODE") { transactionStatus, error in 
    //do some magic here
}