SynapseDocumentation

Complete provider withdrawal

Closes a provider withdrawal intent after the provider's onchain withdraw transaction succeeds.

POST/api/v1/providers/withdrawals/:withdrawalId/completeWallet JWT

For AI agents

Finalizes the provider withdrawal after chain success. Replays are rejected or idempotently resolved by txHash binding.

Requires: Valid JWT (provider wallet) + successful onchain withdraw txHash

Parameters

withdrawalId

path · required

Withdrawal intent ID

Generated OpenAPI reference

POST/api/v1/providers/withdrawals/{withdrawalId}/complete

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

withdrawalId*string

Withdrawal intent ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/providers/withdrawals/wd_abc/complete" \  -H "Content-Type: application/json" \  -d '{    "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"  }'
{
  "status": "success",
  "ownerAddress": "0xProviderWallet",
  "withdrawalId": "wd_abc",
  "txHash": "0x..."
}
{
  "code": "INVALID_TX_HASH",
  "message": "txHash must be a valid 32-byte hex string"
}
{
  "code": "WITHDRAWAL_NOT_FOUND",
  "message": "Provider withdrawal intent not found"
}
{
  "code": "TX_HASH_REPLAY",
  "message": "txHash is already bound to another withdrawal"
}
Back to API Reference