Beneficiary
Add Wallet
API reference for adding wallet payout methods
POST
/
payout
/
methods
/
wallets
Copy
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"
}'
Copy
{
"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:
Copy
{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", // optional
"label": "usdc wallet", // optional
"wallet_address": "0x7fD41923E23DcE32d1A346e96558dA89f89DD1aB",
"network": "bep20",
"currency": "USDC"
}
Headers
Body
application/json
Response
201
application/json
Wallet added successfully
The response is of type object
.
Copy
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"
}'
Copy
{
"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!"
}
Assistant
Responses are generated using AI and may contain mistakes.