Book Transfer File Layout
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 | Standard Validation | 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 | Standard Validation | 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 |
Updated 9 months ago