POST
/
payout
/
methods
/
wallets
curl --request POST \
  --url https://api-staging.stablestack.xyz/api/payout/methods/wallets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "type": "WALLET",
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "label": "usdc wallet",
  "wallet_address": "0x9iu41923E23DcE32d1A346e96558dA89f89DD1aB",
  "network": "bep20",
  "currency": "USDC"
}'
{
"status": "success",
"data": {
"id": "10530920-81eb-451e-a205-16f9ddb1949a",
"type": "WALLET",
"currency": "USDC",
"label": "usdc wallet",
"wallet_address": "0x9iu41923E23DcE32d1A346e96558dA89f89DD1aB",
"network": "bep20",
"created_at": "2025-05-19T19:22:34.511Z",
"updated_at": "2025-05-19T19:22:34.511Z",
"customer_id": null
},
"message": "Merchant payout method added successfully!"
}

Adds a new wallet payout method (either merchant-owned or customer-specific).

  • Include customer_id to create for a specific customer
  • Omit customer_id to create merchant-owned wallet

Request Body:

{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", // optional
  "label": "usdc wallet", // optional
  "wallet_address": "0x7fD41923E23DcE32d1A346e96558dA89f89DD1aB",
  "network": "bep20",
  "currency": "USDC"
}

Headers

x-api-key
string
required

Body

application/json

Response

201
application/json

Wallet added successfully

The response is of type object.