Response & Error Codes

Common HTTP Status Codes

Upon receipt of any HTTP status codes, the Partner can either submit a GET/transfers/{transferId} to find out the status of the transaction or retry the transaction. If the transaction is retried, the POST/Transfer must be with the SAME TransferID so that idempotency is triggered and double-funding is prevented.

Status CodeDescription
200Successful Request. See specific operation to see details for this response.
201Resource was able to be created. See specific operation for details for this response.
400Malformed request; missing fields, incorrect data, or malformed input structure. All possible error codes are listed below in Error Codes section.
400If malformed requestid, an additional error code of 1010 will be sent.
400If malformed endusersecurityid, an additional error code of 1020 will be sent.
400If malformed enduserip, an additional error code of 1030 will be sent.
401Unauthorized. Please provide valid credentials in the authorization header.
404Unable to find resource. Unable to find resource specified by the URL parameter identifier.
405Method Not Allowed. Unable to handle with the specified URI.
409The requestid in the header already exists (duplicate request) in the Green Dot System for the given partner. An additional Error code of 2100 will be sent.
409Unable to proceed because resource already exists in our system and is not in a valid state. See specific operation to see details for this response.
500Internal Server Error.
501Not implemented. Will be implemented at a future date.
502Bad Gateway. The server, while acting as a gateway or proxy, received an invalid response from the upstream server it accessed in attempting to fulfill the request.
503Service Unavailable. The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.
504Gateway Timeout. The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server specified by the URI (e.g. HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed to access in attempting to complete the request.

Common Error Codes

Upon receipt of any HTTP Status Validation Error codes, the Partner can either submit a GET/transfers/{transferId} to find out the status of the transaction or retry the transaction. If the transaction is retried, the POST/Transfer should be with a DIFFERENT TransferID, preferably after any fixes to the request is made. Retrying with the same TransferID will only trigger idempotency and result in the same original response.

HTTP Status 400 Validation Errors

1200Invalid email was specified
1210Invalid phone number was specified
1220Invalid first name value was specified
1221Invalid middle name value was specified
1230Invalid last name value was specified
1240Invalid amount was specified
1250Invalid currency type was specified
1260Invalid account was specified
1270Missing end user security id
1280Missing partner identifier
1290Missing end user ip address
1300Invalid end user IP
1301Invalid Customer Id
1302Invalid Date of Birth
1303Invalid Identification Type
1304Invalid Identification Exp Date
1305Invalid ZipCode
1306Invalid Address
1307Invalid ClaimCode
1308Invalid SSN
1309Invalid State
1310Invalid TransferId
1311Invalid link id
1312Invalid User Id
1313Invalid Password
1314Invalid start date
1315Invalid end date
1316Missing request
1317Missing request id
1318Missing transaction in request
1319Missing transferobjects in request
1320Missing transaction date
1321Missing source uri
1322Missing target uri
1323Invalid User Status
1324Invalid Device Detail
1325Invalid Device Type
1326Invalid User Agreement
1327Transaction Date out of range
1328Missing TransactionFulfillment Status
1329Missing Store Number
1330Missing Inquiry Type
1331Missing ClaimCode
1332Invalid Pin value
1333Invalid Account Token
1334Invalid Last 4 Digits
1335PhoneNumber or Email is required
1336Missing SSN
1337Missing Date of Birth
1338Missing Address
1339Missing State
1340Missing City
1341Missing ZipCode
1342Missing or Invalid Expiry Year
1343Missing or Invalid Expiry Month
1344Missing Pin
1345Missing Transfer Request Id
1346Missing Original Transfer Id
1347Missing Barcode Number
1348Invalid PinReference value
1350Invalid Retailer Information
1351Missing Action Type
1352Invalid Action Type
1353Missing Identification Id
1354Missing Identification Type
1355Missing Identification Issuer
1356Missing Recipient information
1357Invalid Transaction Fulfillment Status
1358Invalid Inquiry Type
1359Invalid BIN
1360Invalid extended BIN
1361Missing transfers in request
1365Invalid Argument Experienced with InternalService
1366Invalid BatchId
1367Invalid Parameters
1368Invalid PartnerId
1369Missing ApiKey
1370Invalid ProgramId
1371Invalid Bank Name
1372Invalid Routing Number
1373Invalid Funding Source Type
1374Invalid Bank Account Type
1375Invalid Nick Name
1376Invalid City
1377Invalid Country
1378Invalid Page
1379Invalid Size
1380Invalid Address1
1381Invalid Address2
1382Missing Or Invalid Last Four SSN

HTTP Status 409 Validation Errors

2100Duplicate request ID
2101Duplicate transfer request ID

Common Response Codes

Upon receipt of any common response codes, the Partner can either submit a GET/transfers/{transferId} to find out the status of the transaction or submit a new transaction. The new transaction should include a different TransferID. Sending the transaction with the same TransferID will only trigger idempotency and result in the same original response.

1No response received for the API request in a pre-defined time period
11No record found
20Invalid customer
40Invalid card status
41No card found
50Parameter – invalid
51Missing parameter or exceeded max length for the field
52Invalid amount
70Invalid partnerIdentifier
80Limit exceeded
90Validation failed
91Card load Failed
99Non-successful – unspecified
100Internal exception
101Internal exception - call to other services failed
102Partner service return failure
103Customer is blocked
112ProgramPartnerIdentifier is not supported
113Transfer id is already completed
114Verify account key failed
123Failed in Green Dot AuthCommit
131Invalid card
153Personalized card not yet activated
159Partially funded
160Load not allowed
161Card lost or stolen
162Personalized card not found
163Card account closed
164Card account blocked
165Card not registered
166Validate Pin other
167Failed OFAC Verification
168Card expired
213Missing valid MasterCard processor configuration UberPayments
301Transfer reversal not allowed
302Invalid barcode fields
303The RetailerKey does not match the barcode retailer key
304Transfer not previously authorized

Common Response Detail Codes

Detail Codes are designed to provide additional detail information about the associated parent response code being returned.

50Exception occurred
3010Sender limit exceeded
3020Recipient limit exceeded
3030Invalid recipient account
3040Other validation failures
3041Invalid customer id
3042There is no customer profile information by the CustomerID and PartnerProgramIdentifier
3043Missing partner program configuration
3046Partner Program Identifier is not allowed for this API
3047No partner client credential found
3048Partner program identifier do not match with original disbursement transfer request
3049Original transfer id is a reversal id
3050Either source or target account does not match original transfer
3052Barcode number not found
3053Invalid retailer Information
3054Account transaction not found
3055Two Phase Commit Transfer not allowed
3056Invalid source account
3057Error encountered with GDN System - transaction successfully voided
3058Invalid UserName
3059No user method groups found
3071File type not supported
3072File size exceeded
3073Invalid BankName
3074Invalid RoutingNumber
3075DebitFundingSourceDetailAccountTransactionType is invalid
3076CreditFundingSourceDetailAccountTransactionType is invalid
3077Invalid identification info
3600Transaction cancelled successfully
3601Transaction cancelled already
4001ACH rejected
4004DCT timeout
4005Partner service error
4010Missing partner identifier
4020Invalid partner identifier
4021Invalid or no corresponding configuration for partner identifier
4030PartnerProgramChannel not supported
4040Amount cannot be less than or equal to 0
4041Amount format is invalid
4050OriginationRequestId cannot be empty
4060SourceProfile's CustomerID cannot be empty
4070TargetProfile's CustomerID cannot be empty
4080Request is null
4100Invalid source profile
4110Invalid target profile
4120Invalid source profile type
4130Invalid Transfer request option
4131Invalid Transfer request option (IsGDNCard)
4132Invalid Transfer request option (OriginalMessageID)
4133Invalid Transfer request option (OriginalConfirmationID)
4134Invalid Transfer request option (TransactionReferenceNumber)
4135Invalid Transfer request option (SourceAccountReferenceNumber)
4136Invalid Transfer request option (TargetAccountReferenceNumber)
4230Invalid target profile type
4250Missing/duplicate request id
4260Missing request transaction
4270Missing request transferobject
4280Missing partner service configuration
4290Missing partner target uri
4300Missing target customer information
4310Missing target profile
4320Missing channel configuration
4330Missing target profile token
4340Mismatch source customer and target customer
4350The program is not supported
4360Missing customer id
4370Missing profile token
4380Invalid transaction date
4390Invalid transfer id
4391Invalid claimCode
4392Invalid transfer id or invalid claimcode
4400Invalid target account token
4410Invalid workflow process activity
4420Invalid workflow activity status
4430Invalid workflow process
4440Invalid workflow process status
4441Invalid DisbursementTransferRequestKey
4442Invalid DisbursementBatchKey
4450Invalid WorkflowProcessExecutionInstanceKey
4460Invalid RegistrationKey
4461No Registration profiles found
4470Missing PIN
4471Missing PIN reference
4480Missing first name
4490Missing last name
4500Missing customer info
4510Missing account token
4513Invalid or missing expiration info
4520Missing last 4 digits
4521Missing BIN
4530Missing card association type
4540Missing account number
4550Missing expiry month
4560Missing expiry year
4570Invalid expiry month
4572Account blocked
4573No Auth request found
4574Invalid profile key
4575Unable to void - already posted or full amount not available
4576Either does not meet minimum or exceeds maximum per transaction amount
4577Account not active
4578Invalid GDN program
4579GDN program blocked
4580Invalid expiry year
4581Invalid payment type
4582Invalid partner ResponseId
4583Invalid processor
4584Exceeds IP audit limit
4585ANI - blocked by Green Dot
4586Account not reloadable
4587Account not eligible
4588Card declined
4589Potential fraud detected
4590Invalid customer key
4591Partner has exceeded the daily limit
4592Transaction limit is less than the minimum configured for the partner
4593Consumer has exceeded the monthly limit configured in the system
4594Per transaction maximum amount limit reached
4595Missing RequestID
4596Missing transfer ResponseCode description
4597Missing transfer ResponseDetailCode description
4598Invalid transfer status ChangeDate
4599Missing partner program identifier
4600Missing phone number
4601Consumer has exceeded the daily load amount limit in the system
4602Consumer has exceeded the daily load count limit in the system
4603Consumer has exceeded the weekly load amount limit in the system
4604Consumer has exceeded the weekly load count limit in the system
4605Consumer has exceeded the monthly load amount limit in the system
4606Consumer has exceeded the monthly load count limit in the system
4610Missing email address
4620Invalid email address
4630Invalid phone number
4640Invalid SSN
4660Invalid processing waiting hours
4670Invalid expired waiting hours
4680Invalid cancel waiting hours
4690Invalid original disbursement transfer request key
4700Invalid original disbursement transfer request id
4710Missing original disbursement transfer request id
4720Reversal amount exceeds original transaction amount
4730Original transfer not successful
4740Invalid reversal amount
4750Original transfer not found
4751Invalid Barcode Status
4752Request ID provided not found
4753Transfer ID provided not found
4800Account balance is less than the reversal amount
4802Refer to card issuer
4807Cardholder not on file
4809Bank not supported by switch
4810Allowable PIN tries exceeded, capture
4812Requested function not supported
4813Insufficient funds on card
4814Incorrect PIN- invalid PIN number
4815Transaction denied - transaction not permitted to cardholder
4818Exceeds withdrawal limit
4821Hard capture, permanent restraint
4822Pin exceeded
4826Transaction decline - violation of law
4830Authorization life cycle expired or unacceptable
4831Inactive card
4832AVS Failed - the AVS validation was not a match
4900Invalid InvalidPartnerKey
4910No transaction is calculated
4920Missing partner list configuration
4921Missing email flag
4922The card type is unknown
4923No valid CardTransfer found
4924Missing PartnerKey
4925Invalid Batch Id
4926Invalid argument experienced with internal service
4927Invalid PartnerId
4928Invalid PartnerName
4929Invalid ProgramId
4930Invalid PartnerProgramId
4931Missing notification product definition token
4932Missing notification type key
4933Missing detail account transaction type
4934Missing or invalid GdGdV3LimitVeriPaymentType
4935Missing personal card / CRV removal configuration
4936Duplicated identifier/record/request ID detected
4937Suspicious fraud
4938Operation is not allowed
4939Failed to add the disbursementtransferledger information for the debit source profile
4940Failed to add the disbursementtransferledger information for the fund target profile
4941Failed to add the disbursementtransferledger information for the credit source profile
4942Failed to update the disbursementtransferrequest information
4943AccountManagement credit API timeout
4944AccountManagement debit API timeout
4945TPG stage failed
4946Missing transaction info
4947Missing identification info
4948Missing credential info
4949Missing TPG processor configuration
4950Missing payment processor configuration
4951Missing disbursement transfer token
4952Missing claim code
4953Missing TransactionId
4954Unable to determine SSN based on last 4 provided