Skip to main content
POST
/
v1
/
ext
/
application-token
Create Application Token - Account Widget
curl --request POST \
  --url https://staging-api.liquidity.walletos.xyz/v1/ext/application-token \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiredAt": "2025-12-31T23:59:59.000Z",
  "tokenType": "ACCOUNT_WIDGET",
  "currency": "USD",
  "extra": {
    "withdrawalSource": "MERCHANT_WALLET",
    "amount": 45,
    "counterparty": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com"
    },
    "accountOptions": [
      "card",
      "bank",
      "venmo",
      "paypal"
    ]
  },
  "externalId": "user-12345",
  "feeHidden": true,
  "redirectTo": "https://example.com/thank-you"
}
'
{
  "data": {
    "url": "https://sandbox.accounts.centryos.xyz/sATjgfpPo1QyfoSFJSQHWTr9Gr3cow",
    "application": {
      "id": "d4c26920-7040-4b12-9ff1-5853f5977f20",
      "token": "sATjgfpPo1QyfoSFJSQHWTr9Gr3cow",
      "tokenType": "ACCOUNT_WIDGET",
      "expiredAt": "2024-07-11T06:57:08.000Z",
      "valid": true
    }
  }
}

Body

application/json
​
expiredAt
string<date-time>
required

Expiration datetime (ISO 8601 format)

Example:

"2025-12-31T23:59:59.000Z"

​
tokenType
enum<string>
required

Token type for payout links

Available options:
ACCOUNT_WIDGET
Example:

"ACCOUNT_WIDGET"

​
currency
string
required

Currency code

Example:

"USD"

​
extra
object
required
​
externalId
string

External identifier to correlate with your system

Example:

"user-12345"

​
feeHidden
boolean

Whether to hide fees from the user

Example:

true

​
redirectTo
string<uri>

URL to redirect user after payout completion

Example:

"https://example.com/thank-you"

Response

200 - application/json

200 - OK

​
data
object