---
title: "Register a wallet payout destination"
method: POST
path: "/api/account/wallet"
tags: ["Accounts"]
---

# Register a wallet payout destination

`POST /api/account/wallet`

Creates a crypto wallet destination. Network is inferred from the wallet address. Use `X-On-Behalf-Of` to target a sub-merchant.

## Request body

- WalletAccountDto
  - `address` string, required — On-chain wallet address
  - `label` string, nullable — Optional custom label

## Response `201`

Register a wallet payout destination successful

- AccountDto
  - `id` string, required — Unique identifier of the payout destination
  - `object` 'bank-account' | 'wallet', required — Destination type
  - `accountOwnerName` string, nullable, required — Account owner name
  - `bankInfo` string, nullable, required — Masked IBAN or account number (last 4 digits only)
  - `iban` string, nullable, required — Full IBAN (bank destinations only)
  - `accountNumber` string, nullable, required — Full account number (bank destinations only)
  - `bic` string, nullable, required — Bank BIC / SWIFT code (bank destinations only)
  - `routingNumber` string, nullable, required — Bank routing number (bank destinations only)
  - `businessName` string, nullable, required — Business name (business bank destinations only)
  - `address` string, nullable, required — Wallet address (wallet destinations only)
  - `country` string, nullable, required — ISO-3166 alpha-2 country code (bank destinations only)
  - `network` string, nullable, required — On-chain network (wallet destinations only)
  - `label` string, nullable, required — Custom label
  - `isArchived` boolean, required — Whether the destination has been archived
  - `createdAt` string, date-time, required — Creation timestamp
  - `updatedAt` string, date-time, required — Last update timestamp
  - `isAvailable` boolean, nullable, required — Whether this destination is available for the current currency filter
  - `withdrawals` string[], nullable, required — List of withdrawal ids that used this destination
  - `needsFileToWithdraw` boolean, required — True for bank accounts that require a file upload before withdrawal
  - `payoutPaused` boolean, required — True when payouts to this bank account are temporarily paused

## Other responses

- `400` — Invalid wallet address or wallet accounts restricted
- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.net/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.net/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/versions/3012dd3dd14a/schema)