API Documentation

Redirecting users to the Web Form

This guide offers an overview of the available query parameters for the Web Form. While these parameters are optional, they can be mixed and matched as necessary. By integrating them into the URL, you can tailor the behavior of the web form to your needs.

Parameter
Description
Example
customerMail


Customer’s e-mail address
example@xyz.com
address


Customer's wallet address
0x0000000000000000000000000000000000000000
currency


Fiat currency
EUR
amount


Amount in the Fiat currency
10
convertedCurrency


Crypto currency
USDC
convertedAmount


Amount in the Crypto currency
10
wallet


Wallet's Network
Polygon
billingStreetAddress


Customer’s street address
Kolejowa 23
billingPostalCode


Customer’s postal code
01-200
billingCity


Customer’s city
Warsaw
billingCountry


Customer’s country
Poland
billingCountryCode


Customer’s country code
PL
billingState


Customer’s state
Mazovian
successUrl


The URL to which the user will be redirected upon successful transaction
failureUrl


The URL to which the user will be redirected upon failed transaction

When both the amount and currency parameters are provided, Kryptonim will execute a conversion of the specified fiat currency to its equivalent value in the chosen cryptocurrency, according to the prevailing exchange rate.


Alternatively, when the convertedAmount and convertedCurrency parameters are specified, Kryptonim will compute the equivalent value in the designated fiat currency, based on the input amount of the identified cryptocurrency, utilizing the current exchange rate.

Usage

Guide users to the Web Form URL, incorporating your chosen parameters. After completing and submitting the form, users will be navigated to the URL specified by either the successUrl or failureUrl parameter, based on the result of the transaction.

Example: 

https://buy.kryptonim.com/form?currency=usd&amount=1&
address=0x0000000000000000000000000000000000000000

Remember to URL-encode the parameter values to correctly format special characters and spaces within the URL.