Skip to main content
POST
/
v2
/
billing
/
fiat-checkout
Generate Fiat Payment URL
curl --request POST \
  --url https://api.tusky.io/v2/billing/fiat-checkout \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "returnUrl": "<string>"
}
'
{
  "checkoutUrl": "<string>",
  "sessionId": "<string>",
  "expiresAt": "<string>"
}
Generate a checkout URL to prepay for Tusky services using fiat currency (credit card). The user is redirected to a payment page. On successful payment, the equivalent SUI amount is credited to the managed wallet.

​
Request Body

​
amount
number
required
Amount in USD to pay (e.g., 50).
​
returnUrl
string
URL to redirect to after payment completes.

​
Response

​
checkoutUrl
string
URL to redirect the user to for payment.
​
sessionId
string
Payment session ID for tracking.
​
expiresAt
string
ISO 8601 timestamp when the checkout URL expires (typically 30 minutes).

​
Example

curl -X POST https://api.tusky.io/v2/billing/fiat-checkout \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50, "returnUrl": "https://app.tusky.io/billing/success"}'

​
Response

{
  "checkoutUrl": "https://checkout.tusky.io/pay/session_abc123",
  "sessionId": "session_abc123",
  "expiresAt": "2026-03-07T15:00:00Z"
}