---
title: "Create Permanent Pay-In Deposit Wallet for Account"
method: POST
path: "/partners/accounts/{account_ref}/payin/address"
tags: ["Partners"]
---

# Create Permanent Pay-In Deposit Wallet for Account

`POST /partners/accounts/{account_ref}/payin/address`

## Request

- Base URL: `//mapi.boomfi.xyz` (relative, and the document’s source URL is not known)
- URL: `//mapi.boomfi.xyz/partners/accounts/{account_ref}/payin/address`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in header `X-API-Signature`
  - API key in header `X-API-Nonce`
- TypeScript: <https://skmtc.dev/boomfi/apis/boomfi-merchants-api/docs/partners/accounts/:account_ref/payin/address/post.ts> (a function with typed inputs; its response is checked against the schema)

Generate a permanent deposit wallet for account pay-ins. Create a dedicated pay-in wallet for an account. Funds deposited to this wallet are automatically swept into the main account. This enables seamless fund aggregation and reduces manual processing.

## Path parameters

- `account_ref` string, required

## Request body

- PartnersGetDepositAddressRequest
  - `chain_id` integer, required: The blockchain network ID to create the deposit wallet on.
  - `currency` string: Optional currency filter. If omitted, the deposit wallet accepts all currencies enabled on the parent account for this chain.
  - `reference` string, required: A unique reference for this deposit wallet, typically a customer identifier. Used to look up the wallet on subsequent calls.

## Response `200`

OK

- InternalResponsePartnersGetDepositAddressResponse
  - `data` PartnersGetDepositAddressResponse
    - `account_id` integer
    - `address` string
    - `chain_id` integer
    - `currency` string
    - `enabled` boolean
    - `reference` string
    - `status` 1 | 2 | 3
  - `error` boolean
  - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/boomfi/apis/boomfi-merchants-api.md) - [All operations](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/llms.txt) - [OpenAPI document](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/revisions/ace3c3df05fe?raw)