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.

For further information regarding card products, please refer to section Product management.

Transfer funds

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

POST /transfers

{ "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 }

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

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.

You can use the above filter parameters in combination as well to get a precise list of transfers.

GET /transfers

{ "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” }

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}

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.