Response Codes
Barcodes and Store Locations Response Codes
Common Response Codes
Following are some common response codes and their displayed descriptions for the GDN client messages.
| Description | Description | Client Message |
|---|---|---|
| 0 | Success | Success |
| 00 | Returned if request completed successfully. | Success |
| 01 | Returned if any parameter is invalid or missing. | Parameter – Invalid |
| 02 | Returned if partner identifier [PartnerCode] is invalid. | Processor – Invalid |
| 03 | Returned if the RequestID is the exact same as another request. | Duplicate Request |
| 04 | Returned if BIN/program is invalid. | Program – Invalid |
| 05 | Returned if BIN/program is blocked. | Program – Blocked |
| 06 | Returned if Payment type is invalid for the corresponding Program. | Payment Type- Invalid |
| 20 | Returned if account is invalid. | Account – Invalid |
| 22 | Returned if account is closed. | Account – Closed |
| 23 | Returned if account is not reloadable. | Account - Not Reloadable |
| 24 | Returned if account is expired. | Account – Expired |
| 25 | Returned if account is lost or stolen. | Account - Lost/Stolen |
| 26 | Returned if account is not active. | Account - Not Active |
| 27 | Returned if account is blocked by Partner. | Account - Blocked by Partner |
| 28 | Returned if account is blocked by Green Dot. | Account - Blocked by Green Dot |
| 39 | Returned if total amount transacted by customer is not in the per transaction limit range. | Invalid Per Transaction Green Dot Program Limit Amount |
| 40 | Returned if total amount transacted by customer exceeded retailer daily limits. | Exceeds Daily Retailer Limits |
| 41 | Returned if total number of transactions performed by customer exceeded Green Dot's daily limits. | Exceeds Daily Green Dot Program Limits – Count |
| 42 | Returned if total amount transacted by customer exceeded Green Dot's daily limits. | Exceeds Daily Green Dot Program Limits – Amount |
| 43 | Returned if total number of transactions performed by customer exceeded Green Dot's weekly limits. | Exceeds Weekly Green Dot Program Limits – Count |
| 44 | Returned if total amount transacted by customer exceeded Green Dot's weekly limits. | Exceeds Weekly Green Dot Program Limits – Amount |
| 45 | Returned if total number of transactions performed by customer exceeded Green Dot's monthly limits. | Exceeds Monthly Green Dot Program Limits – Count |
| 46 | Returned if total amount transacted by customer exceeded Green Dot's monthly limits. | Exceeds Monthly Green Dot Program Limits - Amount |
| 47 | Returned if transaction amount is invalid. | Invalid Amount – Either Does Not Meet Minimum or Exceeds Maximum Amount. |
| 48 | Returned if total number of transactions performed by customer exceeded Partner's daily count limits. | Exceeds Partner Daily Load Limits - Count |
| 49 | Returned if total amount transacted by customer exceeded Partner's daily amount limits. | Exceeds Partner Daily Load Limits - Amount |
| 50 | Returned if total amount transacted by customer exceeded maximum account balance. | Exceeds Max Account Balance |
| 51 | Returned if total number of web attempts performed by customer from the same IP exceeds Green Dot’s Limits | Exceeds IP Audit Limit |
| 52 | Returned if the ANI or customer’s phone number is black listed in Green Dot’s system | ANI – Blocked by Green Dot |
| 53 | Returned if total number of transactions performed by customer exceeded Partner's weekly count limits. | Exceeds Partner Weekly Load Limits - Count |
| 54 | Returned if total amount transacted by customer exceeded Partner's weekly amount limits. | Exceeds Partner Weekly Load Limits - Amount |
| 55 | Returned if total number of transactions performed by customer exceeded Partner's monthly count limits. | Exceeds Partner Monthly Load Limits - Count |
| 56 | Returned if total amount transacted by customer exceeded Partner's monthly amount limits. | Exceeds Partner Monthly Load Limits - Amount |
| 60 | Returned if MoneyPak number is invalid. | MoneyPak - Invalid |
| 61 | Returned if MoneyPak status is not active. | MoneyPak Status - Invalid |
| 63 | Returned if MoneyPak is blocked by Green Dot. | MoneyPak - Blocked |
| 64 | Returned if MoneyPak is already consumed. | MoneyPak - Consumed |
| 65 | Returned if MoneyPak is partially used. | MoneyPak - Insufficient Fund |
| 66 | Returned if there is a funding delay on MoneyPak. | MoneyPak Funding Delay |
| 98 | Returned if original transaction amount loaded to customer’s account cannot be reversed as full amount is not available. | Unable to Void – Already Posted, Full Amount Not Available |
| 99 | Reserved ONLY for system errors.Please use the appropriate error codes above to report any transactional errors. | Non-Successful – Unspecified |
| -999 | Internally generated by Green Dot if no response is received for the API Request from Partner in a pre-defined time period OR Partner can return this response code in a use case where an AuthVoid or AuthCommit should be re-tried. This response code will result in a re-try for AuthVoid and AuthCommit only. | Timeout |
| 111111111 | Success but the oldest barcode will be cancelled | The oldest barcode will be cancelled |
| 351000001 | This is an invalid barcode | Invalid barcode |
| 351000015 | This is an invalid Program | Invalid X_GDN_Program_Number |
| 351000016 | The retailer is invalid | gd_retailer_key is invalid or empty |
| 351000017 | The time stamp is invalid | Invalid X_GDN_TimeStamp or Expired |
| 351000018 | Invalid Parameter. i.e. One or more of required fields are null or empty | FIELDNAME cannot be empty Ex: sender_first_name cannot be empty |
| 351000019 | Invalid Signature Digest | Invalid X_GDN_Signature |
| 351000021 | The Start date is not in valid date format (yyyy-mm-dd) or start date > current date | Invalid start_date |
| 351000022 | The end date is not in valid date format (yyyy-mm-dd) | Invalid end_date |
| 351000023 | Start date > End date | Invalid Date Range. start_date should not be greater than end_date |
| 351000025 | Missing Required Header Fields | Missing Required Header Fields |
| 351000026 | Encryption Type Not Supported | Encryption type not supported |
| 351000027 | Invalid Device Type | Invalid X_GDN_DeviceType |
| 351000028 | Invalid Channel Type | Invalid X_GDN_ChannelType |
| 351000029 | GDFN Load Limits Exceeded | GDFN load limits are exceeded |
| 351000030 | Barcode Velocity Limits Exceeded | Barcode velocity limits are exceeded |
| 351000031 | Invalid Zip Code | Invalid Zip Code |
| 351000032 | Error Occurred in Get Zip Code Location | Error Occurred in Get Zip Code Location |
| 351000033 | Error Occurred in Get Store | Error Occurred in Get Store |
| 351000034 | Invalid Page Number | Invalid Page Number |
| 351000035 | Invalid Latitude | Invalid Latitude |
| 351000036 | Invalid Longitude | Invalid Longitude |
| 351000037 | Invalid Service Type | Invalid Service Type |
| 351000038 | Invalid Count Number | Invalid Count Number |
| 351000039 | Count Number Exceed Maximum | Count Number Exceed Maximum |
| 351000040 | The Given Barcode Amount is less than GDFN's user limits | Amount is less than the minimum transaction amount |
| 351000041 | The Given Barcode Amount is more than GDFN's user limits | Amount is more than the maximum transaction amount |
| 351000042 | Barcode not found | Barcode Id not found |
| 351000044 | Invalid encryption type | Invalid encryption type |
| 351000045 | Invalid gd_barcode_type | Invalid gd_barcode_type |
| 351000046 | If sender_email does not support email format | Invalid sender_email |
| 351000047 | If sender_phone does not support phone number format | Invalid sender_phone |
| 351000048 | If recipient_email does not support email format | Invalid recipient_email |
| 351000049 | If recipient_phone does not support phone number format | Invalid recipient_phone |
| 999999999 | System Error | System Error |
HTTP Response Codes
Following is a complete list of the response codes that the application needs to return for requests. In the event of network or infrastructure issues, the infrastructure may return other response codes.
| HTTP Response Codes | Description |
|---|---|
| 200 OK | The request was completed successfully. |
| 400 BAD REQUEST | General error when the request could not be fulfilled due to problems such as validation errors, missing required data, etc. |
| 401 UNAUTHORIZED | Error code response for a missing or invalid authentication token. |
| 404 NOT FOUND | The requested resource is not found. For example, the PAN is not found or the card is expired. |
Error Codes
Error response messages contain the following parameters.
| Error Code | Error Description |
|---|---|
| ACCOUNT_EXPIRED | Account expired |
| ACCOUNT_NOT_FOUND | Account not found |
| AUTHORIZATION_FAILED | Authorization failed |
| GATEWAY_TIMEOUT | Gateway timeout |
| ACCOUNT_BLOCKED | Account blocked |
Updated about 23 hours ago