Initialize Widget - Zapyd

curl --request POST \
  --url https://sandbox.zapyd.com/widget/initialize \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-SIGNATURE: <api-key>' \
  --header 'X-TIMESTAMP: <api-key>' \
  --data '
{
  "asset_code": "USDT",
  "fiat_amount": "1000",
  "fiat_currency": "INR",
  "flow_type": "buy",
  "network_code": "tron",
  "payment_method": "IMPS",
  "wallet_address": "TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf"
}
'

{
  "message": "Success",
  "status": true,
  "data": {
    "widget_link": "https://app.zapyd.com/login?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcmdfaWQiOiJmZjQ2YjNiMC04NTQ3LTRmNDgtODRhNS00MDdjMzhlMGM0ZTkiLCJhcHBfaWQiOiJ5b3VyX2FwcF9pZCIsImZsb3dfdHlwZSI6ImJ1eSIsImFzc2V0X2NvZGUiOiJVU0RUIiwiYXNzZXRfbmFtZSI6IlRldGhlciIsImFzc2V0X2xvZ28iOiJodHRwczovL2FwcC56YXB5ZC5jb20vYXNzZXRzL2NvaW5zL3VzZHQucG5nIiwiZmlhdF9jdXJyZW5jeSI6IklOUiIsIm5ldHdvcmtfY29kZSI6InRyb24iLCJuZXR3b3JrX25hbWUiOiJUcm9uIiwicGF5bWVudF9tZXRob2QiOiJpbXBzIiwiZmlhdF9hbW91bnQiOiIxMDAwIiwid2FsbGV0X2FkZHJlc3MiOiJUWHFINE1uRHc0NmYzeXlyUndhdTNKRjkyWTFpZTNwQVhmIiwidHlwZSI6IndpZGdldCIsImV4cCI6MTc3NTY3ODkzMSwiaWF0IjoxNzc1Njc3MTMxfQ.3tS9DHVv9rBe4dlRxCivp46L1q1bppx8ZSvO16p38aE&app_id=your_app_id&flow_type=buy"
  }
}

POST

/

widget

/

initialize

curl --request POST \
  --url https://sandbox.zapyd.com/widget/initialize \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-SIGNATURE: <api-key>' \
  --header 'X-TIMESTAMP: <api-key>' \
  --data '
{
  "asset_code": "USDT",
  "fiat_amount": "1000",
  "fiat_currency": "INR",
  "flow_type": "buy",
  "network_code": "tron",
  "payment_method": "IMPS",
  "wallet_address": "TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf"
}
'

{
  "message": "Success",
  "status": true,
  "data": {
    "widget_link": "https://app.zapyd.com/login?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcmdfaWQiOiJmZjQ2YjNiMC04NTQ3LTRmNDgtODRhNS00MDdjMzhlMGM0ZTkiLCJhcHBfaWQiOiJ5b3VyX2FwcF9pZCIsImZsb3dfdHlwZSI6ImJ1eSIsImFzc2V0X2NvZGUiOiJVU0RUIiwiYXNzZXRfbmFtZSI6IlRldGhlciIsImFzc2V0X2xvZ28iOiJodHRwczovL2FwcC56YXB5ZC5jb20vYXNzZXRzL2NvaW5zL3VzZHQucG5nIiwiZmlhdF9jdXJyZW5jeSI6IklOUiIsIm5ldHdvcmtfY29kZSI6InRyb24iLCJuZXR3b3JrX25hbWUiOiJUcm9uIiwicGF5bWVudF9tZXRob2QiOiJpbXBzIiwiZmlhdF9hbW91bnQiOiIxMDAwIiwid2FsbGV0X2FkZHJlc3MiOiJUWHFINE1uRHc0NmYzeXlyUndhdTNKRjkyWTFpZTNwQVhmIiwidHlwZSI6IndpZGdldCIsImV4cCI6MTc3NTY3ODkzMSwiaWF0IjoxNzc1Njc3MTMxfQ.3tS9DHVv9rBe4dlRxCivp46L1q1bppx8ZSvO16p38aE&app_id=your_app_id&flow_type=buy"
  }
}

Initialize Widget

Authorizations

X-API-KEY

string

header

required

API Key for authentication

X-TIMESTAMP

string

header

required

Current timestamp in seconds since epoch

X-SIGNATURE

string

header

required

HMAC SHA256 signature of the request encoded in Base64

Body

application/json

Buy flow
Sell flow

asset_code

string

Cryptocurrency asset code

Example:

"USDT"

fiat_amount

string

Fiat amount the user will pay (buy flow)

Example:

"1000"

fiat_currency

string

Fiat currency code

Example:

"INR"

flow_type

enum<string>

Must be buy for this request shape

Available options:

buy

network_code

string

Blockchain network code for the asset

Example:

"tron"

payment_method

string

Fiat payment method (e.g. IMPS, UPI)

Example:

"IMPS"

wallet_address

string

User's wallet address to receive crypto

Example:

"TXqH4MnDw46f3yyrRwau3JF92Y1ie3pAXf"

Response

Widget initialized successfully. The widget_link opens the widget; query parameters include app_id and flow_type.

status

boolean

required

Example:

true

message

string

required

Example:

"Success"

data

object

required

Hide child attributes

URL to load the widget (includes token, app_id, and flow_type query parameters)