---
title: "Increase Budget Balance"
method: POST
path: "/open-api/v3/budgets/{id}/transfer-in"
tags: ["Budgets"]
---

# Increase Budget Balance

`POST /open-api/v3/budgets/{id}/transfer-in`

The balance of a budget is managed through transfers between the Infinity Account and the budget.This API to allocate funds from the Infinity Account to the budget.

## Path parameters

- `id` string, uuid, required — The UUID of the budget.

## Request body

- BudgetTransferReqDTO
  - `accountId` string, uuid, required — The UUID of the account.
  - `amount` string, required — Transaction amount affecting the budget balance.
  - `clientTransactionId` string, required — User-provided custom transaction ID.

## Response `200`

OK

- BudgetTransactionResponse — budgetTransaction resources
  - `code` string — Return code
  - `message` string — Error message
  - `data` BudgetTransaction — Returned data
    - `id` string, required — The UUID of the transaction.
    - `accountId` string, required — The UUID of the account.
    - `budgetId` string, required — The UUID of the budget.
    - `cardId` string — The UUID of the card.
    - `amount` string, required — Transaction amount
    - `fee` string, required — Transaction fee
    - `feeDetails` FeeDetail[], required — Transaction feeDetails
      - `amount` string — Amount
      - `currency` string — Currency code
      - `feeType` string — Fee Type: 0:Platform Settlement Fee, 1:Apple Pay Fee, 2:ATM Withdrawal Fee, 3:Reversal Fee, 4:Refund Fee
    - `clientTransactionId` string, required — User-provided custom transaction ID.
    - `transactionDisplayId` string, required — Transaction displayId
    - `merchantName` string — Merchant name
    - `mcc` string — Merchant category code (MCC) ,exists in consumer transactions.
    - `mccCategory` string — Industry category of MCC,exists in consumer transactions.
    - `merchantCity` string — Merchant city,exists in consumer transactions.
    - `merchantCountry` string — Merchant country,exists in consumer transactions.
    - `merchantState` string — Merchant state/province,exists in consumer transactions.
    - `merchantZipcode` string — Merchant postal code,exists in consumer transactions.
    - `merchantMid` string — Merchant identification number (MID),exists in consumer transactions.
    - `transactionCurrency` string — Original transaction currency
    - `transactionAmount` string — Original transaction amount
    - `type` string — Transaction type: 0:TransferIn, 1:TransferOut, 2:CreateCardFee, 3:Consumption, 4:Refund, 5:FeeCredit, 6:Fee_Consumption, 7:Declined_Fee, 8:Reversal
    - `status` string, required — Transaction status
    - `createTime` string, timestamp, required — Transaction time timestamp.
    - `detail` string — Transaction detail
    - `businessCodeList` integer[] — Business code identifiers. The complete list of supported business codes and their meanings can be found in the [Business Code Reference](https://developer.interlace.money/docs/card-business-code-reference).
    - `direction` integer — Transaction direction: 1 - Credit (incoming funds), 2 - Debit (outgoing funds)

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/interlace/apis/core-resource.md) · [All operations](https://skmtc.dev/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)