Criar carteira estatica

Crie uma carteira estatica

URL

Autorizacao obrigatoria

POST

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

Formato da requisicaoapplication/json

token

required

string

Codigo do token para o qual a carteira estatica sera criada

network

required

string

Codigo da rede em que a carteira estatica sera criada

order_id

required

string

ID do pedido no seu sistema

webhook_link

url

URL para onde o status do pagamento sera enviado

Padrao: merchant settings

Formato da respostadata object

id

uuid

ID da carteira estatica

order_id

string

ID do pedido no seu sistema

address

string

Endereco final para recebimento do pagamento

token

string

Codigo do token

network

string

Codigo da rede

Exemplos de requisição

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"
}'

Resposta bem-sucedida

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

Erros

A lista detalhada de erros de autorizacao esta em Autorizacao - Erros

{
  "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"
}