When you are passing fiat_amount or crypto_amount_btc combinations the results are following
- fiat_amount=100&crypto_amount_btc=2 – fiat amount is taken
- fiat_amount=100&crypto_amount_btc=2&is_exact_amount=yes – crypto amount is taken
- fiat_amount=100&is_exact_amount=yes – error
- crypto_amount_btc=2 – error
- fiat_amount=100 – fiat amount is taken
This was developed for cases when fiat amount is passed meaning that offers with various bitcoin amounts are shown (vendors set their own margins). But when user needs exactly 1 bitcoin, ‘is_exact_amount’ needs to be added so the offers with various fiat amounts will be shown. Buying 1 BTC costs less when buying with cash deposits (Western Union, Moneygram, and others) compared to gift cards (Amazon, Target, and others).
Callbacks
The Kiosk can be configured to provide callbacks to an outside address on user registration and on a successful trade.
Configuration can be set up on your Kiosk dashboard, under Customize your Kiosk link > Customize your callbacks links. Callbacks can be configured using POST requests only.
First, you have can test your POST request using the Test integration button in Callback Customization Panel. For test it’s enough ti make POST request and not send anything yet, but we expect the code 200/500 to make sure your URL is accessible.
To make integration work, you need to provide the following parameters:
- track_id
- status
- fiat_amount
- fiat_currency
- crypto_amount
- crypto_currency