---
title: "Create bank account recipient"
method: POST
path: "/api/v1/bila/transfer-recipients/bank-account"
tags: ["Transfer Recipients"]
---

# Create bank account recipient

`POST /api/v1/bila/transfer-recipients/bank-account`

Create a new bank account transfer recipient

## Request body

- CreateBankRecipientDto
  - `accountNumber` string, required — Bank account number
  - `bankId` string, required — Bank ID
  - `accountName` string — Account holder name (optional, will be resolved)
  - `country` 'zm' — Country code

## Response `201`

Recipient created successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` RecipientResponseDto
    - `id` string, uuid, required — Recipient UUID
    - `type` 'bank-account' | 'mobile-money', required — Transfer recipient type
    - `accountNumber` string — Bank account number (bank-account only)
    - `accountName` string, required — Account holder name
    - `bankId` string — Bank ID (bank-account only)
    - `bankName` string — Bank name (bank-account only)
    - `phone` string — Phone number (mobile-money only)
    - `operator` string — Mobile money operator (mobile-money only)
    - `country` string, required — Country code
    - `createdAt` string, date-time, required — Creation timestamp

## Other responses

- `400` — Invalid recipient details

---

[API](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api.md) · [All operations](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilasdk/bila-payment-gateway-api/revisions/1e6976632889/schema)