API Documentation

Event Notification File

A record of notable events which have occurred in CorePro in the past hour.

Event Notification File Definition

This file is created by CorePro on an hourly basis. It has the following properties:

  1. Fixed-length. Header row is 129 bytes excluding line endings. Each content row is 363 bytes excluding line endings.
  2. ANSI encoded
  3. Line endings are Windows-style CarriageReturn + LineFeed (\r\n, or 0x0D0A)
  4. File will be available in the relative directory of /EventNotification
  5. File name follows a specific, case-sensitive pattern of: yyyyMMddhhmm_EVENTNOTIFICATION.TXT
  6. Root-relative path on sftp.corepro.io for that file would be: /EventNotification/201809060605_EVENTNOTIFICATION.TXT

Format Disclaimer
Social Money reserves the right to append new field(s) to the end of any Header or Content line without notice. This is to allow new data points to be added as needed in a timely fashion.

Implementation Note
Your code should be written such that unexpected characters after the "last" field but prior to the end of each line should be ignored. That is, if the file is documented as being 872 bytes per line, receiving a file with 984 bytes per line should not disrupt your processing. This applies to both Header and Content lines.

File Name Disclaimer
The date in file name should be used as a guideline for human eyes only. Any date-related programmatic dependencies should rely on the FileCreatedDate or FileEffectiveDate contained within the header line of each file, as these will be precise to the second and will be in the appropriate timezone.

Header Row

Property Data Type (Length) Alignment Start Position Description
RecordType string (1) Left 1 The flag for the header row. Will always be H.
FileName string (50) Left 2 The name of this request file excluding path. Will be named following this pattern:
  1. yyyyMMddhhmm_EVENTNOTIFICATION.TXT
  2. Example: 201809060605_EVENTNOTIFICATION.TXT
RecordCount integer (10) Right 52 The number of records represented within the file.
NOTE: This field is zero-padded on the left side. e.g.: 0000000872
FileCreatedDate datetime (34) Right 62 The date the file was created.
Follows same format as API e.g.: 2014-10-20T10:30:31.456-05:00. See date format details.
FileEffectiveDate datetime (34) Right 96 The date to which the data in the file pertains.
Follows same format as API e.g.: 2014-10-20T23:59:59.999-05:00. See date format details.

Content Row

Property Data Type (Length) Alignment Start Position Description
CustomerId integer (10) Right 1 The unique identifier for a Customer.
NOTE: This field is zero-padded on the left side. e.g.: 0000000872
CustomerTag string (50) Left 11 The client-supplied unique identifier for the customer, aka the tag property on the customer object. This may be empty as it is an optional property.
AccountId integer (10) Right 61 The unique identifier for the account to which this event applies. May be 0000000000 if this event does not apply to a specific AccountId.
NOTE: This field is zero-padded on the left side. e.g.: 0008309285
This is NOT an accountNumber. It is the accountIdof an account object.
AccountTag string (50) Left 71 The client-supplied unique identifier for the account, aka the tag property on the account object to which this event applies. This is an optional field and may be empty.
ExternalAccountId integer (10) Right 121 The unique identifier for the externalAccount object to which this event applies. May be 0000000000 if this event does not apply to a specific ExternalAccountId.
NOTE: This field is zero-padded on the left side. e.g.: 0008309285
This is NOT an accountNumber. It is the externalAccountIdof an externalAccount object.
ExternalAccountTag string (50) Left 131 The client-supplied unique identifier for the externalAccount, aka the tag property on the externalAccount object. This may be empty as it is an optional property.
TransactionId integer (19) Right 181 The unique identifier for the transaction.
NOTE: This field is zero-padded on the left side. e.g.: 0008309285
TransactionTag string (50) Left 200 The client-supplied unique identifier for the transaction. See transaction object definition for details.
Description string (50) Left 250 A human-readable description of the event. See EventTypeId definition below for list of possible values.
EventTypeId integer (10) Right 300 The type of event that occurred. See the following list for all possible values:
  • 1 : Authenticate - Successful
  • 2 : Authenticate - Failed
  • 1001 : Created New Bank Holiday
  • 1002 : Modified Bank Holiday
  • 1003 : Removed Bank Holiday
  • 1004 : Modified Bank Information
  • 2001 : Modified Program Information
  • 2002 : Modified Program Settings - Deposit
  • 2003 : Modified Program Settings - Interest
  • 2004 : Modified Program Settings - Regulator
  • 2005 : Modified Program Settings - Withdrawal
  • 3001 : Modified Customer Details
  • 3002 : Added Note Customer
  • 3003 : Added Note Customer Verification
  • 3004 : Manually Approved Customer Verification
  • 3005 : Manually Denied Customer Verification
  • 3006 : Locked Customer Account
  • 3007 : Unlocked Customer Account
  • 3008 : Locked External Account
  • 3009 : Unlocked External Account
  • 3010 : Created External Account
  • 3011 : Modified External Account
  • 3012 : Verified External Account
  • 3013 : Resend Verify External Account
  • 3014 : Voided Account Transaction
  • 3015 : Voided External Account Transaction
  • 3016 : Reversed Account Transaction
  • 3017 : Reversed External Account Transaction
  • 3018 : Added Fee or Credit to Customer Account
  • 3019 : Modified Recurring Contribution
  • 3020 : Modified Customer Information
  • 3021 : Modified Customer Beneficiary Information
  • 3022 : Modified Customer Contact Information
  • 3023 : Modified Customer Residential Address
  • 3024 : Modified Customer Mailing Address
  • 3025 : Modified Customer CorePro Information
  • 3026 : Closed Customer Account
  • 3027 : Modified Customer Account Number
  • 3028 : Petty Cash - Check Issued
  • 3029 : Petty Cash - Check Issuance Cancelled
  • 3050 : Customer Name Change - Approved
  • 3051 : Customer Name Change - Denied
  • 3052 : Customer Address Change - Approved
  • 3053 : Customer Address Change - Denied
  • 3054 : Auto Approved Customer Verification
  • 3055 : Auto Denied Customer Verification
  • 3056 : Auto Expired Customer Verification - Initiated
  • 3057 : Auto Expired Customer Verification - Manual Review
  • 3058 : Funding Source Verified
  • 3059 : Created Customer Account
  • 3060 : Created Account Transaction

    Deprecated; broken out to 3060XXX values

  • 3061 : Modified Customer Account Information
  • 3062 : Monthly Statement Available
  • 3063 : Customer Closed
  • 3064 : Recurring Contribution Initiated
  • 3065 : Customer Identity Screening
  • 3066 : eCode Purchase
  • 3067 : External Account - Awaiting Verification
  • 3068 : Customer Verification - Application Abandon
  • 3069 : Customer External Account Archived
  • 3070 : Target  Amount Has Been Met
  • 3101 : Transaction Settled
  • 3102 : Transaction Funds Available
  • 3501 : Tax 1099-INT Available

    3501; Production only event

  • 4001 : Modified Client Information
  • 5001 : Unknown Event Logon User
  • 5002 : Modified Admin Logon User
  • 5003 : Deleted Admin Logon User
  • 5004 : Locked Admin Logon User
  • 5005 : Requested Password Reset on Logon User
  • 5006 : Password Reset on Logon User
  • 5007 : Archived Admin Logon User
  • 6001 : Sent NACHA File to Shazam
  • 7001 : R07 - Initiated
  • 7002 : R07 - Completed
  • 7003 : R10 - Initiated
  • 7004 : R10 - Completed
  • 7005 : R08 - Initiated
  • 7006 : R08 - Completed
  • 10001 : Debit Card Initiated
  • 10002 : Debit Card Pending
  • 10003 : Debit Card PendingVerification
  • 10004 : Debit Card Verified
  • 10005 : Debit Card Denied
  • 10006 : Debit Card Expired
  • 10007 : Debit Card Archived
  • 10009 : Debit Card Locked By Customer
  • 10010 : Debit Card Unlocked By Customer
  • 10011 : Debit Card Locked By Admin
  • 10012 : Debit Card Unlocked By Admin
  • 10013 : Debit Card Added Account
  • 10014 : Debit Card Removed Account
  • 10015 : Debit Card Lost Or Stolen
  • 10016 : Debit Card Reset Requested
  • 10017 : Debit Card Authorization Hold
  • 10018 : Debit Card Reissued With Existing PAN
  • 10019 : Debit Card Reissued With New PAN
  • 3001001 : Admin - Accepted Customer Document
  • 3001002 : Admin - Rejected Customer Document
  • 3060000 : Transaction - Generic / Unknown
  • 3060005 : Transaction - Bank Income to Internal (BNKDEP)
  • 3060010 : Transaction - Cash to Internal (CSHWTH)
  • 3060015 : Transaction - Cash to Program Reserve (CSHRSV)
  • 3060025 : Transaction - Cash to Return Clearing (CSHRET)
  • 3060030 : Transaction - Cash to Verification Fund (CSHVER)
  • 3060035 : Transaction - External to Internal (CPDEP)
  • 3060040 : Transaction - General Journal Deposit (GENDEP)
  • 3060045 : Transaction - General Journal Withdrawal (GENWTH)
  • 3060050 : Transaction - Interest Adjustment (INTADJ)
  • 3060055 : Transaction - Internal to Cash (CSHDEP)
  • 3060060 : Transaction - Internal to External (CPWTH)
  • 3060065 : Transaction - Internal to Interest Expense ()
  • 3060070 : Transaction - Internal to Internal (CPXFR)
  • 3060075 : Transaction - Internal to Miscellaneous (MSCWTH)
  • 3060080 : Transaction - Internal to Program Clearing (PCLWTH)
  • 3060085 : Transaction - Internal to Program Reserve (RSVWTH)
  • 3060090 : Transaction - Internal to Retail Clearing (RTLWTH)
  • 3060095 : Transaction - Internal to Unknown External (UNKWTH)
  • 3060100 : Transaction - Miscellaneous to Internal (MSCDEP)
  • 3060105 : Transaction - Program Account to Unknown External (RSVUNK)
  • 3060110 : Transaction - Program Clearing to Program External (PCLWTH)
  • 3060115 : Transaction - Program External to Internal (PXTDEP)
  • 3060120 : Transaction - Program Reserve to Cash (RSVCSH)
  • 3060125 : Transaction - Program Reserve to Internal (RSVDEP)
  • 3060130 : Transaction - Program Reserve to Verification Fund (RSVVER)
  • 3060135 : Transaction - Retail Clearing to Internal (RTLDEP)
  • 3060140 : Transaction - Retail Clearing to Retail External (RTLWTH)
  • 3060145 : Transaction - Return Clearing to Internal (RCLDEP)
  • 3060150 : Transaction - Return Deposit (RTNDEP)
  • 3060155 : Transaction - Return Withdraw (RTNWTH)
  • 3060165 : Transaction - Unknown External to Internal (UNKDEP)
  • 3060170 : Transaction - Unknown External to Program Account (UNKRET)
  • 3060175 : Transaction - Verification Fund to External (VERWTH)
  • 3060240 : Card Authorization - Purchase (ATHPCH) - POS transaction as a credit or online purchase
  • 3060242 : Card Authorization - Cash Withdrawal (ATHCSH) – Future use
  • 3060244 : Card Authorization - Debit Adjustment (ATHDBT) – Future use
  • 3060246 : Card Authorization - Billpay (ATHBLP) – Future use
  • 3060248 : Card Authorization - Funds Transfer Debit (ATHFTD) – Future use
  • 3060250 : Card Authorization - Merchandise Return (ATHRTN) – Future use
  • 3060252 : Card Authorization - Deposit (ATHDEP) – Future use
  • 3060254 : Card Authorization - Credit Adjustment (ATHCDT) – Future use
  • 3060256 : Card Authorization - Point Of Business Deposit (ATHPOB) – Future use
  • 3060258 : Card Authorization - Funds Transfer Credit (ATHFTC) – Future use
  • 3060260 : Card Authorization - Transfer Funds (ATHXFR) – Future use
  • 3060262 : Card Authorization - AFD (ATHAFD) – (AFD = Automated Fuel Dispenser) – Authorization happens when fuel transaction initiated
  • 3060341 : Card Transaction - Purchase (CRDPCH) – POS transaction as Debit – Typically if PIN or Chip were used
  • 3060343 : Card Transaction - Cash Withdrawal (CRDCSH) - ATM Cash Withdrawal
  • 3060345 : Card Transaction - Debit Adjustment (CRDDBT) - When card network provider manually Debits funds - Typically rare
  • 3060347 : Card Transaction - Billpay (CRDBLP) - Debit transaction for Billpay
  • 3060349 : Card Transaction - Funds Transfer Debit (CRDFTD) - P2P withdrawal
  • 3060351 : Card Transaction - Merchandise Return (CRDRTN) - Return of goods or services, Credit applied
  • 3060353 : Card Transaction - Deposit (CRDDEP)
  • 3060355 : Card Transaction - Credit Adjustment (CRDCDT) - When card network provider manually Credits funds - Typically rare
  • 3060357 : Card Transaction - Point Of Business Deposit (CRDPOB)
  • 3060359 : Card Transaction - Funds Transfer Credit (CRDFTC) - P2P Deposit
  • 3060361 : Card Transaction - Transfer Funds (CRDXFR) - Transfer between accounts tied to same card
  • 3060363 : Card Transaction - AFD (CRDAFD) - (AFD = Automated Fuel Dispenser) - When fuel transaction complete
  • 3060471 : Card Reversal - Purchase (REVPCH) - Error occurred on merchant device (ie, POS) and reverses a corresponding purchase
  • 3060473 : Card Reversal - Cash (REVCSH) - Error occurred with ATM and corresponding transaction is reversed
  • 3060475 : Card Reversal - Debit Adjustment (REVDBT)
  • 3060477 : Card Reversal - Billpay (REVBLP)
  • 3060479 : Card Reversal - Funds Transfer Debit (REVFTD)
  • 3060481 : Card Reversal - Merchandise Return (REVRTN)
  • 3060483 : Card Reversal - Deposit (REVDEP)
  • 3060485 : Card Reversal - Credit Adjustment (REVCDT)
  • 3060487 : Card Reversal - Point of Business (REVPOB)
  • 3060489 : Card Reversal - Funds Transfer Credit (REVFTC)
  • 3060493 : Card Reversal - AFD (REVAFD)
  • 3060500 : Check Deposit Authorization
  • 3060501 : Check Deposit
  • 3060502 : Check Deposit Reversal
TransactionTypeCode string (6) Left 310 A programmatic code for the type of transaction. See transaction object definition for details.
TransactionSettledDate string (34) Left 316 The date and time the transaction was settled. See transaction object definition for details.
TransactionAvailableDate string (34) Left 350 The date and time the funds associated with the transaction became available. See transaction object definition for details.
UserEventID integer (19) Right 384 Used to reconcile with Realtime Event message being received.

Example Event Notification File

Content: See 201809060605_EVENTNOTIFICATION.TXT


NOTE: Your browser or text editor may wrap the text to fit the window or silently convert the delimiter tab characters to spaces. Actual source file does not wrap and has delimiter tab characters.

Ready to start a conversation?

Email Us