Create static wallet

Create a static wallet

POST

https://api.fps.pro/invoices/wallet

Request formatapplication/json

token

required

string

Token code for which the static wallet will be created

network

required

string

Network code where the static wallet will be created

order_id

required

string

Order ID in your system

webhook_link

url

URL where the payment status will be returned

Default: merchant settings

Response formatdata object

id

uuid

Static wallet ID

order_id

string

Order ID in your system

address

string

Final address for receiving payment

token

string

Token code

network

string

Network code

Request examples

curl --request POST 'https://api.fps.pro/invoices/wallet/' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE' \
  --data '{
  "token": "tether",
  "network": "tron",
  "order_id": "ORD-1001",
  "webhook_link": "https://merchant.example.com/webhooks/static-wallet"
}'

Successful response

{
  "status": 200,
  "message": "wallet created",
  "data": {
    "id": "95b97d47-4f0f-4822-8f26-4c3550fd1b7a",
    "order_id": "order-1001",
    "address": "TQ5x...abc",
    "token": "tether",
    "network": "tron"
  }
}

Errors

Detailed authorization errors are listed in Authorization - Errors

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "token",
      "message": "token is required"
    }
  ]
}
{
  "status": 404,
  "message": "No token/network pairing found"
}
{
  "status": 500,
  "message": "Internal Server Error"
}