Guides
Guides
Guides

Managing beneficiary target wallet details

For non-custodial implementations, manage the target wallet details for your beneficiaries

❗️

This functionality is only for implementations that are not using Caliza's USDC custody features.

Overview

For implementations that use their own custody, rather than Caliza's custody, you can freely retrieve and update the target wallet for on-ramps.

Updating destination wallet for a beneficiary

curl --request PUT \
     --url https://sandbox.api.caliza.co/core-api/v1/beneficiaries/{beneficiaryId}/walletAddress \
     --header 'Authorization: Bearer {{YOUR_TOKEN}}' \
     --header 'Content-Type: application/json' \
     --data-raw '{
  "address": "{wallet_address},
	"chain": "{MATIC|SOL}"
  }
}'

This should return a 200 if the update is successful.

Retrieving destination wallet for a beneficiary

curl --request GET \
     --url https://sandbox.api.caliza.co/core-api/v1/beneficiaries/{beneficiaryId}/walletAddress \
     --header 'Authorization: Bearer {{YOUR_TOKEN}}' \
     --header 'Content-Type: application/json' 

This should return a JSON object that looks like this.

{
  "walletAddress": "{walletAddress}",
  "chain": "{chain}"
}