- Checkout Implementation
7 min read | Updated 16 Feb 2021 | Category Partner | User AvatarAlin Ionut

Checkout Implementation

Want to be our Partner? Please contact us to gain details and start onboarding. Checkout represents a way for your platform users to trade crypto in a fast and secure way, powered by our API. In order to gain access, you will need to have a valid platform enrolled in

Once you accomplish that, you will receive the following:

Platform ID


Platform Code


JWT Private


JWT Public


For best security, JWT RSA Keys are encoded in 2048 bit.

Checkout Base URL

Checkout Query Params

Parameter Values Required Info
platform xxxxxxxx Your platform code.
token xxxxxxxxxxxxxxxxxxxxxxxx JWT RS512 encoded with provided keys.¹
- - - -
lang {ro|en|de} - Select the language for the checkout. Default: en.
display {light|dark} - Select the theme for the checkout. Default:light
landing {true|false} - Select if you want to skip the checkout landing page. Default:false
  1. Encryption algorithm can be change from your Partner dashboard. We support: RS512, RS384, RS256, HS512, HS384 and HS256.

Checkout URL Example

Token Payload Checkout Example (JWT RS512 encoded)

  "user": {
    "id": "1",
    "username": "username",
    "email": "",
    "first_name": "John",
    "last_name": "Doe",
    "dob": "2000-01-31",  
    "wallet": "0xfFf75cb3916570824CcEFFe589193c2452383C17",
    "phone": "40730000000",
    "country": "RO",
    "city": "Pitesti",
    "street": "Street details here",
    "zip": "111111"
  "payment": {
    "operation": "buy",
    "type": "coin",
    "symbol": "ETH",
    "amount": "10",
    "fiat": "EUR",
    "request_id": "1",
    "method": "card",
    "second_order_type": "withdraw"
    "attempts": "3"
  "redirect_url": "",
  "ping_url": "",
  "ip": "",
  "expire": 1571848640

Token Payload Checkout Details

Property Validations Required Info string|max:191 User identification on your platform.
user.username alpha_dash|max:191 - User username on your platform. email User email.
user.wallet alpha_num|max:191 - User wallet address.¹ numeric|digits_between:7,17 - User phone.
user.first_name alpha_dash|max:191 User first name.
user.last_name alpha_dash|max:191 User last name.
user.dob date_format:Y-m-d User date of birth.² countryISOcode - User country ISO code.³ alpha_dash|max:191 - User city. alpha_num|between:4,10 - User ZIP code.
user.street string|max:191 - User street details.
- - - -
payment.operation in:buy,sell Transaction side.
payment.type in:coin,token Transaction type.
payment.symbol in:ETH,XBT,IPSX,etc Transaction crypto symbol.
payment.amount numeric Transaction crypto amount. in:EUR,USD,etc Transaction fiat symbol.
payment.request_id unique|max:191 Transaction request ID.
payment.method in:card,bank Transaction payment method.
payment.second_order_type in:withdraw|withdrawIco - Transaction second operation after “buy”.¹
payment.attempts integer|max:5 - Transaction max quote attempts.
- - - -
redirect_url url Web location to redirect after checkout is finalized.
ping_url url - Web location where platform will send notification events.⁴
ip ip - Restrict checkout access by IP address.
expire integer|digits:10 Represents checkout request expiration date.⁵
  1. If wallet is not provided, the funds will remain in user balance. If is provided, a “payment.second_order_type” operation must be set as “withdraw”, and after "buy" order is Approved, a second Withdraw order will be automatically triggered.
  2. User must have at least 18 years.
  3. To get a list with all supported countries, interrogate API /countries endpoint.
  4. If ping_url is different than your Platform IEN URL, we will send data to this address as well as on Platform IEN URL.
  5. If this date is passed, checkout request will no longer be available.

Token Payload Checkout Details Extra

  1. Payment.type - Available values depends on your platform settings in platform.
  2. Payment.symbol - Available values depends on your platform settings in platform.
  3. Payment.amount - If user has no other order in our platform, limitation may be applied to the maximum amount available for first order.
  4. - Available values depends on your platform settings in platform.
  5. Payment.method - Available values depends on your platform settings in platform.

If this do not answer your questions, please do not hesitate to contact us at

Go Top