---
agentTools:
  projectIndex: https://safehavenmfb.readme.io/llms.txt
---

# Transfers

Transfers represent movement of funds from one account to another. It can be intra bank (within Safe Haven) or NIP (which are just transfers to external banks). <br>

**Endpoints**

[block:parameters]
{
  "data": {
    "h-0": "Method",
    "h-1": "Url",
    "0-0": "<span style=\"color:green\">`GET` </span>",
    "0-1": "[/transfers/banks](https://safehavenmfb.readme.io/reference/bank-list)",
    "1-0": "<span style=\"color:orange\">`POST` </span>",
    "1-1": "[/transfers/name-enquiry](https://safehavenmfb.readme.io/reference/name-enquiry)",
    "2-0": "<span style=\"color:orange\">`POST` </span>",
    "2-1": "[/transfers](https://safehavenmfb.readme.io/reference/transfer)",
    "3-0": "<span style=\"color:orange\">`POST` </span>",
    "3-1": "[/transfers/status](https://safehavenmfb.readme.io/reference/transfer-status)",
    "4-0": "<span style=\"color:green\">`GET` </span>",
    "4-1": "[/transfers](https://safehavenmfb.readme.io/reference/get-transfers)"
  },
  "cols": 2,
  "rows": 5
}
[/block]

**Flow**

1. [Bank List](https://safehavenmfb.readme.io/reference/bank-list): get the beneficiary's `bankCode`.
2. [Name Enquiry](https://safehavenmfb.readme.io/reference/name-enquiry): confirm the account name. Keep the returned `sessionId`.
3. [Transfer](https://safehavenmfb.readme.io/reference/transfer): send that `sessionId` as `nameEnquiryReference`, with a unique `paymentReference`.
4. [Transfer Status](https://safehavenmfb.readme.io/reference/transfer-status): check the final result using `sessionId` or `paymentReference`, or wait for the `outward.transfer` webhook.

**Transfer statuses**

| Status       | Meaning                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------- |
| `Created`    | Accepted; final result not known yet.                                                             |
| `Processing` | Being confirmed with NIBSS.                                                                       |
| `Completed`  | Successful.                                                                                       |
| `Failed`     | Failed and the sender was **not** debited. No refund needed.                                      |
| `Reversed`   | Failed after the sender was debited; the amount and fees were credited back (`isReversed: true`). |

> 🚧 Retrying
>
> If a transfer times out or its status is unclear, check [Transfer Status](https://safehavenmfb.readme.io/reference/transfer-status) before you send it again. Never reuse a `paymentReference`.