---
title: "Set funding address for Flow transfer"
method: POST
path: "/entities/{entityDID}/flow/{transferId}/fund"
tags: ["Flow Internal"]
---

# Set funding address for Flow transfer

`POST /entities/{entityDID}/flow/{transferId}/fund`

Allows onramps (agents in a Flow transfer) to provide funding address information.
The funding information is stored in the transfer (replacing any existing) and a Fund
TAP message is broadcast to all agents in the transfer. This endpoint should be called
after the onramp is added as an agent to the Flow transfer.

## Path parameters

- `entityDID` string, did, required — Decentralized Identifier (DID)
- `transferId` string, uuid, required

## Request body

- object
  - `amount` string, required — Amount to fund in the specified currency
  - `currency` string, required — Currency code (ISO-4217 for fiat)
  - `fundingAddress` string — CAIP-10 address for crypto funding
  - `fundingAccount` string — PayTo URI for fiat funding (RFC 8905). Supports iban, ach, bitcoin, void types.
  - `for` string, required — DID of the party this funding is for (customerDID or merchantDID)
  - `fee` string — Optional fee percentage

## Response `200`

Funding address added successfully

- object
  - `success` boolean
  - `transfer` object — Updated transfer object
  - `fundingAddress` object
    - `amount` string
    - `currency` string
    - `fundingAddress` string
    - `fundingAccount` string
    - `for` string
    - `fee` string
    - `addedBy` string
    - `addedAt` string, date-time

## Other responses

- `400` — Invalid request or transfer is not a Flow transfer
- `403` — Entity is not an agent in this transfer
- `404` — Transfer not found
- `500` — Internal Server Error - An unexpected condition was encountered on the server.

---

[API](https://skmtc.net/notabene/apis/notabene-api.md) · [All operations](https://skmtc.net/notabene/apis/notabene-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notabene/notabene-api/revisions/70056745a433/schema)