---
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`

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.net/boomfi/apis/boomfi-merchants-api.md) · [All operations](https://skmtc.net/boomfi/apis/boomfi-merchants-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/boomfi/boomfi-merchants-api/revisions/ace3c3df05fe/schema)