# Transfers

### Introduction

nCore platform support fund transfer from one account to another account. Using this fund transfer method you can move funds between your own account as well as to any other user’s account which is also known as a peer to peer (P2P) transfer. The fund transfer method has a real time effect which means that the funds will be debited from the sender account and immediately credited to the recipient account.

#### **Account transfers pre-requisite**

Following are the prerequisites for funds sender and funds receiver accounts.

<img src="https://3730541649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftelq9krTgSM8OvsHep7r%2Fuploads%2FV95e1srF0cSX4SsKya3F%2Ffile.drawing.svg?alt=media&#x26;token=359af7c6-4929-4ff8-91c4-75401c57af56" alt="" class="gitbook-drawing">

For further information regarding card products, please refer to section [**Product management**](https://docs.nymcard.com/get-started/product-management).

### Transfer funds&#x20;

You can transfer funds from one account to another account by sending a POST request to /transfers endpoint as given below.

<details>

<summary><a href="https://nymcard.com/docs/api#tag/Fund-Transfers/operation/transfer">POST /transfers</a></summary>

**`{`**\
`    `**`"sender_account_id": "bc121529-e6e9-45f1-b820-8c46ce7f005a",`**\
`    `**`"recipient_account_id": "39dbff34-5505-4181-9e81-727b71e72186",`**\
`    `**`"amount": 100,`**\
`    `**`"currency": "USD",`**\
`    `**`"notes": "Account transfer for 100 USD",`**\
`    `**`"dry_run": false`**\
\&#xNAN;**`}`**

</details>

### Retrieve transfers

The nCore platform offers the following retrieval options for transfers.

**Retrieve all transfers**

You can retrieve all existing transfers by sending a **GET** request to **/transfers** endpoint shown below.

> [**GET /transfers**](https://nymcard.com/docs/api#tag/Fund-Transfers/operation/getTransfers)

**Retrieve a list of transfers by filters**

You can retrieve transfers by using the applicable filters given below.

| **Filter parameter**        | **Description**                                                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| sender\_account\_id         | Sender account Identifier. You can use sender account id to get all the account transfers performed by a user.           |
| recipient\_account\_id      | Recipient account Identifier. You can use the receiver's account id to get all the account transfers received by a user. |
| transfer\_date\_time\_start | Date and time of a transfer, starting with which you want to filter a list of transfers.                                 |
| transfer\_date\_time\_end   | Date and time of a transfer, ending with which you want to filter a list of transfers.                                   |

{% hint style="info" %}
You can use the above filter parameters in combination as well to get a precise list of transfers.
{% endhint %}

<details>

<summary><a href="https://nymcard.com/docs/api#tag/Fund-Transfers/operation/getTransfers"><strong>GET /transfers</strong></a></summary>

**`{`**\
`    `**`"transaction_id": "123456789012",`**\
`    `**`"sender_account_id": "bc121529-e6e9-45f1-b820-8c46ce7f005a",`**\
`    `**`"recipient_account_id": "39dbff34-5505-4181-9e81-727b71e72186",`**\
`    `**`"transfer_date_time_start": “10012021",`**\
`    `**`“transfer_date_time_end”: “11012021”`**\
\&#xNAN;**`}`**

</details>

**Retrieve a specific transfer**

You can retrieve a specific transfer by sending a **GET** request to **/transfers/{id}** endpoint, where id is the transfer ID.

> [**GET /transfers/{id}**](https://nymcard.com/docs/api#tag/Fund-Transfers/operation/getTransfer)

### Transfer between user's OWN account/wallet

We've implemented new enums for the 'transfer\_type' parameter, enabling the system to differentiate whether a transfer occurs between the user's OWN account/wallet or not. When transferring between the user's own accounts, the transfer\_type will indicate 'OWN' (e.g. CHA2CHAOWN).

Here are the various account types and their meanings:

* CHA: Cardholder Account
* CHCA: Cardholder Child Account
* AMA: Agent Master Account
* AMCA: Agent Master Child Account
* CHMCA: Cardholder Master Child Account
* CHMA: Cardholder Master Account

Furthermore, we've added a new 'transfer\_type' field to the TRANSACTIONS [webhook](https://docs.nymcard.com/get-started/webhooks/webhooks-samples#transaction-webhook).<br>