Enumeration Definitions

ACH Categories

Following are valid categories for ACH transaction types. These may appear anywhere ACH transactions appear, including methods to get individual or lists of transactions, and individual webhooks.

ACH CategoryValue Returned in Transaction Schema
State Tax Refundstr
Federal Tax Refundftr
Tax Refund Loantrl
Government Benefitsgb
Child Supportcs
Internet Transferit
Payrollpr
Unknownuk
SPECIALspc
Commercialcom
Other Payopy
Unemploymentui
Pensionpn

Discard Reasons

The following values may be returned on a declined check deposit attempt. Green Dot may return additional values in the future.

discardReasonNotes
3 rd Party Items are not accepted via mobile deviceChecks made to someone other than the account holder cannot be deposited by mobile devices.
Altered ItemsSuspected alternation that is not necessarily fraudulent May result in blocked account if deemed to be altered in a fraudulent way
Back of check not endorsed for Mobile DepositChecks without a signature written on the back.
Check is void due to dateChecks that cannot be deposited due to expired dates.
Check will not clear at this timeThese are checks requiring further validation due to suspicious circumstances, such as a date over six months.
Declined ActivityCustomers who have multiple declined and returned checks. May result in a blocked account if decline activity exceeds allowable threshold.
Duplicate ItemChecks that have already been deposited.
Endorsement missingChecks without signature written on the back.
Exceeds 30-Day Rolling Deposit LimitConsecutive checks that exceed the 30-day deposit amount limit.
Exceeds Daily LimitChecks that exceed the daily deposit limit.
High Risk ItemsItems such as money orders, loan checks, or cashier/official checks.
Illegible imageChecks with image defects (blurry, etc.).
MICR line is not being accepted. Please take ….The MICR line on the check is either invalid or will not scan properly.
Non- negotiableMissing endorsement, missing maker signature, VOID written on check, stale date (over 6 months), non-check item (coupon), etc.
Non-Conforming ImageThese are checks that include characteristics such as faint writing, colorful backgrounds, out-of-spec printing.
Non-negotiableChecks or deposit slips that cannot be exchanged for cash.
Payee not on accountThe payee account details are invalid and/or the account is not found.
Per members requestChecks for which the account holder has rejected for deposit.
Restrictive Endorsement MissingChecks without “for mobile deposit only” written on the back.
Third Party CheckChecks made to someone other than the account holder, a partial name mismatch, or PPO (Preferred Provider Organization) reviewer is unable to verify the relationship with the account holder.

External Bank Verification Method

These are the only acceptable values for bankAccountVerificationMethod during ACH Pull Transactions.

ValueDescription
YodleeThe external bank account has been validated using the 3rd party Yodlee API.
QuovoThe external bank account has been validated using the 3rd party Quovo API.
PlaidThe external bank account has been validated using the 3rd party Plaid API.
Micro DepositsThe external bank account has been validated via micro deposits made to the account and verified by the accountholder.

Payment Amount Option for AMM Rule

When a payment is made to a loan or credit product via automatic money movement, one of these values is returned. These will be returned in object in Camel Case.

paymentAmountOption
Minimum payment
Current Balance
Statement Balance
Other Amount

Payment Identifier Status

These will be returned in objects in Camel Case.

Payment Identifier Status
Activated
Not Activated
Not Activated
Closed

Payment Identifier Status Reasons

These will be returned in objects in Camel Case.

PaymentIdentifierStatusReasons
Lost/Stolen
Customer Initiated Hold
Awaiting Call Back
Confirmed Fraud
Account Block
Customer Initiated Closing
Issuer Initiated Closing
Falcon
Virtual Analyst
Mass Compromised
Lost
Stolen
UnauthorizedUse
Compromised

Payment Instrument Status

These will be returned in objects in Camel Case.

Payment Instrument Status
Activated
Not Activated
Deactivated

Payment Instrument Status Reasons

These will be returned in objects in Camel Case.

PaymentInstrumentStatusReasons
Damaged
Never Received
Returned Mail
Expired
Unused Card
Lost/Stolen
Upgraded
Name Change
SuspiciousActivity
MassCompromised
Lost
Stolen
UnauthorizedUse
Compromised

Payment Instrument Type

These will be returned in object in Camel Case

PaymentInstrumentType
Virtual
Magstripe
EMV
ContactlessEmv

Source Option for AMM rule

When a payment is made to a loan or credit product via automatic money movement, one of these values is returned. These will be returned in object in Camel Case

sourceOption
DDA
ACH Pull

Terms Identifiers

The table below represents values that can be sent as a terms acceptance terms Identifier. See your Green Dot representative for specific terms the accountholder must send.

Terms IdentifierDescriptionRequired at Enrollment
DaaAccount AgreementY
EcaElectronic Communications AgreementY
privPlcyDebit Card Data Sharing Opt InY
isIRSCertTaxpayer ID Certification AgreementN
billPayBill Pay AgreementN
CsaCredit Card Cardholder & Security AgreementN
dataShareDataShare AgreementN
ecasccElectronic Communications Agreement - Secured CardsN
EqCSAEquifax Credit Score AgreementN
eWalletTCeWalletTermsConditionsN
MobileAppMobile App TermsN
mrdcMobile Remote Deposit Capture AgreementN
negBalTerms for Backup Balance featureN
overdraftTerms for Overdraft Tier AgreementN
privPlcyscCredit Card Data Sharing Opt InN
svngsPurseCushion/Envelope AgreementN
TcpaInfoTCPA Informational Messaging Express ConsentN
TcpaPromoTCPA Promotional Messaging Express Written ConsentN
TechPrivcyTechnology Privacy StatementN