Overview

Book Transfers are a method to which a customer can transfer funds between two accounts on Evolve's Core System. These accounts cannot be vAccounts.

Example: Fintech A has two Evolve Accounts, an Operating Account A and Operating Account B. Instead of initiating an On-Us ACH transaction to move funds, Fintech A can prepare the below file layout to transfer funds from one account to the other.

Book Transfer File Layout

Request File Name

BookTransfer_CompanyShortName_yyyyMMddHHmmss.transfer

BookTransferidentifies the file type
CompanyShortNameis the short name assigned to the company by Evolve
yyyyMMddHHmmssis the timestamp of when the file is delivered to Evolve

Response File Name

transfer_results_ClientName_yyyyMMddHHmmssfffffff_Random6DigitNumber.json

transfer_resultsidentifies the file type
ClientNameis the short name assigned to the company by Evolve
yyyyMMddHHmmssfffffffis the timestamp of when the file is delivered to Evolve
Random6DigitNumberis a random number generated by Evolve

File Direction

This file is sent to Evolve from the Platform or Third Party

Delivery Methods

sFTP

File Format Options

JSON

Data Delivery Window

Delivery of this file can occur daily (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)

Unique Key

Evolve requires that the data from this file be stored in association with a unique key. This key will help the Platform identify errors or duplicate data in the event of a system issue.

Required Fields:
File Name + reference

{
  "transfers": [
    {
      "account_to": {
        "account_number": "9999999999"
      },
      "account_from": {
        "account_number": "9999999999"
      },
      "transfer_info": {
        "amount": 0.01,
        "reference": "II84EWSKMNPGFNZ"
      }
    }
  ]
}

{
  "transfer_results": [
    {
      "account_from": {
        "account_number": "9999999999"
      },
      "account_to": {
        "account_number": "9999999999"
      },
      "transfer_info": {
        "amount": 0.01,
        "reference": "II84EWSKMNPGFNZ"
      },
      "filename": "BookTransfer_CompanyShortName_yyyyMMddHHmmss.transfer",
      "results": {
        "SC": 200,
        "XferKey": "TVZQIULQLM",
        "RsStat": "Success"
      }
    }
  ]
}

Book Transfer Request File Table

Field Name	Data Type	Description
account_to	object	The account_to object passes data associated with the destination FBO account
account_to.account_number		This is the destination FBO account number
account_from	object	The account_from object passes data associated with the source FBO account
account_from.account_number		This is the source FBO account number
transfer_info	object	The transfer_info object passes additional data associated Book Transfer
amount		This is the amount of the transfer
reference		This is a 15 character client defined unique alpha numeric value

Book Transfer Response File Table

Field Name	Data Type	Description
account_to	object	The account_to object passes data associated with the destination FBO account
account_to.account_number	string	This is the destination FBO account number
account_from	object	The account_from object passes data associated with the source FBO account
account_from.account_number	string	This is the source FBO account number
transfer_info	object	The transfer_info object passes additional data associated Book Transfer
amount	integer	This is the amount of the transfer
reference	string	This is a 15 character client defined unique alpha numeric value
Filename	string	This is the file name from the request file
results	object	This object passes result data from the request file
SC	integer	This is the response Status Code
XferKey	string	This is a unique key Evolve associates with the request
RsStat	string	This is a description of the Response status