Additional query params can be added to widget allowing to skip steps within payment flow.
Example string:
<https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=blue&type=narrow&swap_enabled=true>
These parameters define the payment methods and allow skipping the step to choose a payment category.
| Parameter | Available Values | Description | Example |
|---|---|---|---|
payment_category |
VISA_MC, PIX, OPEN_BANKING, REVOLUT_PAY, SEPA, SWIFT, SPEI, GOOGLE_PAY, APPLE_PAY, PSE |
Specifies the payment category. | VISA_MC |
skip_choose_payment_category |
true, false |
If true, skips the step where the user chooses a payment category. |
true |
These parameters allow defining custom URLs for redirecting users based on different outcomes of the transaction (success, failure, or cancellation).
| Parameter | Description | Example |
|---|---|---|
redirects_successful |
URL to redirect after a successful transaction. | https://guardarian.com |
redirects_failed |
URL to redirect after a failed transaction. | https://guardarian.com |
redirects_cancelled |
URL to redirect after a canceled transaction. | https://guardarian.com |
These parameters control the appearance and color scheme of the widget.
| Parameter | Available Values | Description | Example |
|---|---|---|---|
theme |
gradient, green, blue, orange |
Sets the overall theme color of the widget. | blue |
calc_background |
crimson, hex_ff0000 |
Background color for the calculator. | crimson |
button_background |
crimson, hex_ff0000 |
Background color for buttons. | hex_ff0000 |
button_background_disabled |
crimson, hex_ff0000 |
Background color for disabled buttons. | crimson |
body_background |
crimson, hex_ff0000 |
Background color for the widget body. | crimson |
without_box_shadow |
true |
Removes the box shadow from the widget if true. |
true |
widget_height |
- | Sets the height of the widget in pixels. | 600 |
active_tab_background |
crimson, rgb(0,0,0) |
Background color for active tabs. | rgb(0,0,0) |
active_tab_color |
white, rgb(0,0,0) |
Text color for active tabs. | white |
select_background |
black, rgb(0,0,0) |
Background color for dropdowns. | black |
select_color |
white, rgb(0,0,0) |
Text color for dropdowns. | white |
submit_button_color |
black, white |
Text color for the submit button. | black |
| Parameter | Description | Example |
|---|---|---|
default_crypto_currency |
ETH |
|
default_crypto_network |
BASE |
|
default_swap_from_currency |
ETH |
|
default_swap_from_network |
BASE |
|
default_swap_to_currency |
ETH |
|
default_swap_to_network |
BASE |
These parameters define how the checkout content is displayed (e.g., in the same tab, a new tab, or within an iframe).
| Parameter | Available Values | Description | Example |
|---|---|---|---|
create_nav_behaviour |
same_tab, new_tab, iframe |
Defines how the new content is opened: in the same tab, a new tab, or within an iframe. | same_tab |
Example:
<iframe
src="<https://guardarian.com/calculator/v1/?partner_api_token=PARTNER_API_TOKEN&create_nav_behaviour=new_tab>"
allow="camera;microphone;fullscreen;payment"
style="height: 363px; width: 480px; border: none">
</iframe>