Transfers

Overview

The Transfers module of the Customer API facilitates the movement of funds and manages transfer-related operations with a suite of endpoints tailored to cover various functionalities:

1. Create Internal Fiat Transfer: This endpoint allows customers to conduct internal fund transfers between two customer asset accounts within the system. The users need to specify the source and destination account IDs, the amount to be transferred, and a reference note for the transaction.

2. Create External Fiat Transfer: Customers can perform external transfers from their asset account using this endpoint. It supports both domestic and international transfers, requiring information about the source account, transfer type, payee details, saved payee preferences, amount, reference note, and the purpose code for the transaction.

3. Create External Fiat Transfer With Originator: Customers can perform external transfers from their asset account using this endpoint. User's have the ability to set the transaction's originator, and thus affect how the sender's details appear in the receiver's account. It supports both domestic and international transfers, requiring information about the source account, transfer type, payee details, saved payee preferences, amount, reference note, and the purpose code for the transaction.

4. Get Purpose Codes: This endpoint provides a list of available purpose codes that are to be used for external fiat transfers. It helps in categorizing the transfer types for internal use, such as "Transfer to own account" or "Family Maintenance".

5. Create Internal Crypto Transfer: This endpoint allows customers to conduct internal cryptocurrency transfers between two customer asset accounts within the system. The users need to specify the source and destination account IDs, the amount to be transferred.

---

Create Internal Fiat Transfer

Make an internal fiat transfer between two customer asset accounts

Create Fiat internal transfer

Request Headers:

• IdempotencyKey: Unique GUID value generated by user to identify subsequent retries of a request (optional)

Request body parameters:

• SourceAccountId: Source asset account id
• DestinationAccountId: Destination asset account id
• Amount: Fiat transfer amount
• Reference: Purpose of transaction

Response:

• Id : Transfer Id

Possible validation errors:

• Required
• User_Not_Found
• Invalid_Source_Account
• Invalid_Destination_Account
• Invalid_Asset : If both account's asset are different
• Insufficient_Funds

POSThttps://public-api.ibanera.com/api/v1/customer/transfers/fiat/createinternaltransfer

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

sourceAccountId*integer (int32)

destinationAccountId*integer (int32)

amount*number (double)

reference*string

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.FiatTransferResultDto (object)

Request

JavaScriptCurl

const response = await fetch('https://public-api.ibanera.com/api/v1/customer/transfers/fiat/createinternaltransfer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({
      "amount": 0,
      "reference": "text"
    }),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "amount": 0,
    "description": "text",
    "dateTime": "2024-05-09T05:02:54.191Z",
    "bPending": false
  }
}

Example Request Body

{
   "SourceAccountId":2141,
   "DestinationAccountId":2143,
   "Amount": 1000,
   "Reference": "Internal Fiat Transfer Test"
}

Example Success Response

{
    "id": 1008,
    "status": "1",
    "errors": []
}

---

Create External Fiat Transfer

Make an external transfer from a customer asset account, using either a Wire or ACH. Refer to Purpose Codes to categorize a transfer.

Create Fiat external transfer

Request Headers:

• IdempotencyKey: Unique GUID value generated by user to identify subsequent retries of a request (optional)

Request body parameters:

• SourceAccountId: Source asset account id
• TransferType: Wire Or ACH
• Amount: Fiat transfer amount
• Purpose: Purpose of transaction
• Reference: Reference ( FBO accounts, this should be reference to identify the account)
• bSavePayee: Flag identifies whether to save new payee or not
• Payee : Either existing payee id or destination account details

Response:

• Id : Transfer Id

Possible validation errors:

• Required
• User_Not_Found
• Invalid_TransferType
• International_Transfer_Not_Allowed
• Invalid_PayeesId
• Invalid_Country
• Invalid_Currency
• Invalid_Source_Account
• Insufficient_Funds

POSThttps://public-api.ibanera.com/api/v1/customer/transfers/fiat/createexternaltransfer

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

sourceAccountIdinteger (int32)

transferTypeAvamaeTemplate.Core.Enums.TransferTypes (enum)

01

amountnumber (double)

payeeAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.PayeeRequestDto (object)

bSavePayeeboolean

referencenullable string

purposeCodenullable string

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.FiatTransferResultDto (object)

Request

JavaScriptCurl

const response = await fetch('https://public-api.ibanera.com/api/v1/customer/transfers/fiat/createexternaltransfer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "amount": 0,
    "description": "text",
    "dateTime": "2024-05-09T05:02:54.191Z",
    "bPending": false
  }
}

Payee Request Parameters

When configuring a payee, you can either use payeesId to use an existing payee, or provide payee information directly. Additionally, you can refer to the Payees API Endpoints to access various functionality such as creating, retrieving, modifying, and deleting payees.

{
  ...
  "payee": {
  
    // Option 1: Use payeesId to reference a Payee
    "payeesId": 0,
    
      
    // Option 2: Use the following fields to detail a payee
    "countryCode": "string",
    
    //Either Routing Number or Swift Code is available
    "routingNumber": "string",
    "swiftCode": "string",
  
    "accountNumber": "string",
    "accountName": "string",
    
    
    "type": "string",
    "name": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "townCity": "string",
    "state": "string",
    "postcode": "string"
  },
  ...
}

Example Request Body

The format of the request body is different between Domestic USA transfers and international transfers. Refer to the following examples for reference:

Domestic Wire Transfer Request Body

{
        "SourceAccountId":2141,
        "TransferType":"Wire",
        "Payee":{
                "CountryCode":"USA",
                "RoutingNumber":"125000105",
                "AccountNumber":"2140632999",
                "AccountName":"Test account",
                "Type":"Personal",
                "Name":"Test Account",
                "AddressLine1":"1 TestAddress",
                "TownCity":"TestTown",
                "State":"TestCounty",
                "Postcode":"N19AA"
        },
        "bSavePayee":true, 
        "Amount": 100,
        "Reference": "Test Transfer", 
        "PurposeCode" : "PUC002"
}

International Wire Transfer Request Body

{
        "SourceAccountId": 2141,
        "TransferType": "Wire",
        "Payee": {
                "CountryCode": "SGP",
                "SwiftCode": "DBSSSGSG",
                "AccountNumber": "12342346545123",
                "AccountName": "Sebi Scaria",
                "Type":"Company",
                "Name": "Sebi Scaria",
                "AddressLine1": "62 UBI road 1",
                "TownCity": "Oxley Bizhub 2",
                "Postcode": "408734"
        },
        "bSavePayee":true,
        "Amount": 50,
        "Reference": "Test Transfer", "PurposeCode": "PUC002"
}

Example Success Response

{
    "id": 1008,
    "status": "1",
    "errors": []
}

---

Create External Fiat Transfer With Originator

Make an external transfer with a user defined originator from a customer asset account, using either a Wire or ACH. Refer to Purpose Codes to categorize a transfer.

Create Fiat external transfer with originator

Request Headers:

• IdempotencyKey: Unique GUID value generated by user to identify subsequent retries of a request (optional)

Request body parameters:

• SourceAccountId: Source asset account id
• TransferType: Wire Or ACH
• Amount: Fiat transfer amount
• Purpose: Purpose of transaction
• Reference: Reference ( FBO accounts, this should be reference to identify the account)
• bSavePayee: Flag identifies whether to save new payee or not
• Payee: Either existing payee id or destination account details
• Originator : Originator details
  • CompanyId: Company Identification
  • Name: Originator name
  • AddressLine1: Used for the street address
  • AddressLine2: Used for the city, state, and postal code
  • AddressLine3: Any information, for example, country code or information related to the wire
  • Data: Originator Data. Nacha refers to this as Company Discretionary Data Response:
• Id : Transfer Id

Possible validation errors:

• Required
• User_Not_Found
• Invalid_TransferType
• International_Transfer_Not_Allowed
• Invalid_PayeesId
• Invalid_Country
• Invalid_Currency
• Invalid_Source_Account
• Insufficient_Funds

POSThttp://public-api.ibanera.com/api/v1/customer/transfers/fiat/createexternaltransferwithoriginator

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

sourceAccountIdinteger (int32)

transferTypeAvamaeTemplate.Core.Enums.TransferTypes (enum)

01234

amountnumber (double)

payeeAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.PayeeRequestDto (object)

bSavePayeeboolean

referencenullable string

purposeCodenullable string

originatorAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.OriginatorRequestDto (object)

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.FiatExternalTransferRequestWithOriginatorDto (object)

Request

JavaScriptCurl

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/transfers/fiat/createexternaltransferwithoriginator', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "transferType": 0,
    "amount": 0,
    "payee": {
      "name": "text",
      "type": 0,
      "countryCode": "text",
      "routingNumber": "text",
      "accountNumber": "text",
      "swiftCode": "text",
      "accountName": "text",
      "addressLine1": "text",
      "addressLine2": "text",
      "townCity": "text",
      "state": "text",
      "postcode": "text"
    },
    "bSavePayee": false,
    "reference": "text",
    "purposeCode": "text",
    "originator": {
      "companyId": "text",
      "name": "text",
      "addressLine1": "text",
      "addressLine2": "text",
      "addressLine3": "text",
      "data": "text"
    }
  }
}

Payee Request Parameters

When configuring a payee, you can either use payeesId to use an existing payee, or provide payee information directly. Additionally, you can refer to the Payees API Endpoints to access various functionality such as creating, retrieving, modifying, and deleting payees.

{
  ...
  "payee": {
  
    // Option 1: Use payeesId to reference a Payee
    "payeesId": 0,
    
      
    // Option 2: Use the following fields to detail a payee
    "countryCode": "string",
    
    //Either Routing Number or Swift Code is available
    "routingNumber": "string",
    "swiftCode": "string",
  
    "accountNumber": "string",
    "accountName": "string",
    
    
    "type": "string",
    "name": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "townCity": "string",
    "state": "string",
    "postcode": "string"
  },
  ...
}

Originator Request Parameters

The settable parameters for the originator depend on whether the transfer is a Wire or an ACH transfer.

{
  ...
  "Originator":{
        //Required for ACH transfers
        "CompanyId":"string",
        
        //Required
        "Name":"string",
        
        //Optional for Wire transfers. Must be null for ACH transfers
        "AddressLine1":"string",
        
        //Optional for Wire transfers. Must be null for ACH transfers
        "AddressLine2":"string",
        
        //Optional for Wire transfers. Must be null for ACH transfers
        "AddressLine3":"string",
        
        //Optional for ACH transfers. Must be null for Wire transfers
        "Data":"string"
    },
  ...
}

Example Request Body

The format of the request body is different between Domestic USA transfers and international transfers. Refer to the following examples for reference:

Domestic Wire Transfer Request Body

{
   "SourceAccountId":2141,
   "TransferType":"Wire",
    "Payee":{
        "CountryCode":"USA",
        "RoutingNumber":"125000105",
        "AccountNumber":"2140632999",
        "AccountName":"Test account",
        "Type":"Personal",
        "Name":"Test Account",
        "AddressLine1":"1 TestAddress",
        "TownCity":"TestTown",
        "State":"TestCounty",
        "Postcode":"N19AA"
    },
    "Originator":{
        "CompanyId":null,
        "Name":"Test name",
        "AddressLine1":"street address",
        "AddressLine2":"town",
        "AddressLine3":"country",
        "Data":null
    },
    "bSavePayee":true,
   "Amount": 10,
   "Reference": "Test Transfer",
   "PurposeCode" : "PUC002"
}

International Wire Transfer Request Body

{
    "SourceAccountId": 2141,
    "TransferType": "Wire",
    "Payee": {
        "CountryCode": "SGP",
        "SwiftCode": "DBSSSGSG",
        "AccountNumber": "12342346545123",
        "AccountName": "Sebi Scaria",
        "Type":"Company",
        "Name": "Sebi Scaria",
        "AddressLine1": "62 UBI road 1",
        "TownCity": "Oxley Bizhub 2",
        "Postcode": "408734"
    },
    "Originator":{
        "CompanyId":null,
        "Name":"Test name",
        "AddressLine1":"street address",
        "AddressLine2":"town",
        "AddressLine3":"country",
        "Data":null
    },
    "bSavePayee":true,
    "Amount": 50,
    "Reference": "Test Transfer",
    "PurposeCode": "PUC002"
}

Example Success Response

{
    "id": 22026,
    "details": {
        "id": 30939,
        "accountsId": 2141,
        "fromTransactionsId": null,
        "fromAccountsId": null,
        "toTransactionsId": null,
        "toAccountsId": null,
        "amount": -10,
        "description": "External transfer - Family Maintenance",
        "dateTime": "2024-02-15T17:05:09.97+00:00",
        "bPending": true
    },
    "status": "1",
    "errors": []
}

---

Get Purpose Codes

Get list of available purpose codes to be used for external fiat transfer.

List of transfer purpose codes

Response:

• Code: Purpose Code
• Description: Purpose Description

GEThttps://public-api.ibanera.com/api/v1/customer/transfers/purpose-codes

Header parameters

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.TransfersModule.TransferPurposeCodes (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

JavaScriptCurl

const response = await fetch('https://public-api.ibanera.com/api/v1/customer/transfers/purpose-codes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": [
    {
      "code": "text",
      "description": "text"
    }
  ]
}

Example Success Response

{
    "id": 0,
    "details": [
        {
            "code": "PUC001",
            "description": "Transfer to own account"
        },
        {
            "code": "PUC002",
            "description": "Family Maintenance"
        }
    ],
    "pageSize": 10,
    "pageNumber": 1,
    "status": "1",
    "errors": []
}

---

Create Internal Crypto Transfer

This endpoint initiates a transfer of crypto currency between two asset accounts that are accessible by a manager. The endpoint requires parameters for the source account ID, the destination account ID, and the amount for the transfer. The asset to be transferred is inferred by the asset account ID.

• Endpoint: /api/v1/customer/accounts/crypto/move

• Method: POST

Move crypto between customers account

Request query:

• fromAccountsId: source account id
• toAccountsId : destination account id
• amount: Amount to withdraw (must be >0) Response:
• customerId: customer id
• customerReference : reference given when creating the customer
• fromTransaction : Details of transaction associated with fromAccountsId
• toTransaction : Details of transaction associated with toAccountsId

Possible validation errors:

• Required
• Invalid

POSThttp://public-api.ibanera.com/api/v1/customer/accounts/crypto/move

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

fromAccountsId*integer (int32)

toAccountsId*integer (int32)

amount*number (double)

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Results.ObjectResultDto`1[[AvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.ShareCustomerCryptoFundsResponseDto, AvamaeTemplate.Core, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]] (object)

Request

JavaScriptCurl

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/accounts/crypto/move', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({
      "amount": 0
    }),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "status": "text",
    "errors": [
      {
        "fieldName": "text",
        "messageCode": "text"
      }
    ],
    "details": {
      "customerReference": "text",
      "fromTransaction": {
        "amount": 0,
        "description": "text",
        "dateTime": "2024-05-09T05:02:54.191Z",
        "bPending": false
      },
      "toTransaction": {
        "amount": 0,
        "description": "text",
        "dateTime": "2024-05-09T05:02:54.191Z",
        "bPending": false
      }
    }
  }
}

Request Body Example

{
    "fromAccountsId": 1001, // Integer - Required
    "toAccountsId" : 1002, // Integer - Required
    "amount": 0.01 // Decimal - Required
}

Response Body Example

{
    "id": 0,
    "details": {
        "customersId": 1001,
        "customerReference": "your-customer-reference",
        "fromTransaction": {
            "id": 10001,
            "accountsId": 1001,
            "fromTransactionsId": null,
            "fromAccountsId": null,
            "toTransactionsId": 10002,
            "toAccountsId": 1002,
            "amount": -0.010000000000000000,
            "description": "Transfer of crypto to managing account 1001",
            "dateTime": "2024-01-01T18:21:39.7633333+00:00",
            "bPending": true
        },
        "toTransaction": {
            "id": 10002,
            "accountsId": 1002,
            "fromTransactionsId": 10001,
            "fromAccountsId": 1001,
            "toTransactionsId": null,
            "toAccountsId": null,
            "amount": 0.010000000000000000,
            "description": "Receipt of crypto from managee account 1002",
            "dateTime": "2024-01-01T18:21:39.77+00:00",
            "bPending": true
        }
    },
    "status": "1",
    "errors": []
}