Servicing Error Codes
Void Error Codes
| Error Codes | HTTP Response Code | Error Description |
|---|---|---|
| OM_VOID_0001 | 409 Conflict | The void request failed due to card already redeemed. Please contact support for further assistance |
| OM_VOID_0002 | 404 Not Found | The void request failed. Unable to locate card by reference. Please contact support for further assistance |
| OM_VOID_0003 | 409 Conflict | The void request failed due to invalid card status. Please contact support for further assistance |
| OM_VOID_0004 | 200 OK | The card is already voided. Please contact support for further assistance |
| OM_VOID_0005 | 500 Internal Server Error | Internal system error. Please contact support for further assistance. |
| OM_VOID_0006 | 200 OK | The card is already voided. Please contact support for further assistance |
| OM_VOID_0007 | 409 Conflict | The void request failed due to invalid card or account. Please contact support for further assistance |
| OM_VOID_0008 | 404 Not Found | The void request failed. Unable to locate line item by reference. Please contact support for further assistance |
| OM_VOID_0009 | 404 Not Found | The void request failed. Unable to locate order by reference. Please contact support for further assistance |
| OM_VOID_0014 | 404 Not Found | The void request failed. Unable to locate card by proxy card id. Please contact support for further assistance |
Resend Error Codes
| Error Codes | HTTP Response Code | Error Description |
|---|---|---|
| OM_RESEND_1001 | 422 Unprocessable Entity | The order is still processing and not eligible for a resend |
| OM_RESEND_1002 | 422 Unprocessable Entity | Resend eGift is not applicable for physical cards |
| OM_RESEND_1003 | 400 Bad Request | The Order Line ID does not match the given Order ID. Please check the Order Line ID and Order ID. |
| OM_RESEND_1004 | 400 Bad Request | Resend eGift is not applicable for Sync orders |
| OM_RESEND_1005 | 400 Bad Request | Please enable at least one of Email or SMS fields to be resent |
| OM_RESEND_1006 | 400 Bad Request | Resend eGift by Email is not allowed for partner, please contact support team for more details |
| OM_RESEND_1007 | 400 Bad Request | Resend eGift by SMS is not allowed for partner, please contact support team for more details |
| OM_RESEND_1008 | 200 - Email is failed but SMS is successful 400 Bad Request (only Email) | Failed to resend eGift by email for this order |
| OM_RESEND_1009 | 200 - SMS is failed but Email is successful 400 Bad Request (only SMS) | Failed to resend eGift by SMS for this order |
Suspend Error Codes
| Error Codes | HTTP Response Code | Error Description |
|---|---|---|
| SERV_AUTH_001 | 401 | Authentication failed. A valid BHN bearer token is required. Refresh or replace the token and retry. |
| SERV_AUTH_002 | 403 | Access denied for this operation. Please contact your BHN Account Manager to request access. |
| SERV_SUSP_003 | 404 | No item was found for the identifier provided. Please verify the identifier value and type, then retry the request. |
| SERV_SUSP_004 | 400 | Please provide items as a non-empty array of identifiers and retry the request. |
| SERV_SUSP_004 | 400 | Please provide a valid suspend reason code in reason.reasonCode, then retry the request |
| SERV_SUSP_004 | 400 | Please provide a readable reason in reason.reason, then retry the request. |
| SERV_SUSP_005 | 409 | Suspend cannot be applied because the requested item is not eligible for suspension in its current state. Please do not retry unless the item's state changes. |
| SERV_SUSP_006 | 429 | Request rate limit exceeded. Please retry after the delay indicated in the Retry-After response header (60s) |
| SERV_SUSP_007 | 500 | The suspend request could not be completed due to an unexpected internal error. Please retry with exponential backoff. If the issue continues, contact BHN support and provide the requestId. |
| SERV_SUSP_008 | 404/207 | This item is missing a required identifier. Provide exactly one of the itemType identifiers and try again. |
| SERV_SUSP_009 | 404/207 | This item's identifier does not match the required format (3–64 characters, letters, numbers, underscores, and hyphens only). Please correct the identifier and resubmit. |
| SERV_SUSP_010 | 404/207 | This identifier appears more than once in the request. Only the first occurrence was processed — remove the duplicate and resubmit if this item needs a separate action. |
| SERV_SUSP_011 | 404/207 | No item was found for the identifier provided. Please verify the identifier value and type, then retry the request. |
| SERV_SUSP_012 | 409/207 | The item is already suspended. Please do not retry unless the item state changes. |
| SERV_SUSP_013 | 409/207 | The item is voided and cannot be suspended. Please do not retry unless the item state changes." |
| SERV_SUSP_014 | 404/207 | The identifiers provided for this item do not match our records for the same item. Please verify the identifiers correspond to the same item and resubmit. |
| SERV_SUSP_015 | 404/207 | More than one eGift is associated with this account. Please resubmit this item using its specific eGiftId. |
| SERV_SUSP_016 | 404/207 | More than one eGift is associated with this retrievalReferenceNumber. Please resubmit this item using its specific eGiftId or cardReferenceId instead. |
| SERV_SUSP_017 | 500/207 | This item could not be processed due to an internal error. Retry this item with exponential backoff. If it continues to fail, contact BHN support with the requestId and this item's identifier. |
| SERV_SUSP_018 | 500/207 | This item could not be processed because of a temporary service issue on our end. Please retry this item individually with exponential backoff. If it continues to fail, contact BHN support with the requestId and this item's identifier." |
| SERV_SUSP_019 | 413 | The request could not be processed because it contains more items than are allowed in a single request. Please reduce the number of items and resubmit. |
| SERV_SUSP_020 | 409 | A request with the same requestId is already being processed. Please retry the identical request (same requestId) after a short delay. |
Unsuspend Error Codes
| Error Codes | HTTP Response Code | Error Description |
|---|---|---|
| SERV_AUTH_001 | 401 | Authentication failed. A valid BHN bearer token is required. Refresh or replace the token and retry. |
| SERV_AUTH_002 | 403 | Access denied for this operation. Please contact your BHN Account Manager to request access. |
| SERV_UNSUS_003 | 404 | No item was found for the identifier provided. Please verify the identifier value and type, then retry the request. |
| SERV_UNSUS_004 | 400 | Please provide items as a non-empty array of identifiers and retry the request. |
| SERV_UNSUS_004 | 400 | Please provide a valid suspend reason code in reason.reasonCode, then retry the request |
| SERV_UNSUS_004 | 400 | Please provide a readable reason in reason.reason, then retry the request. |
| SERV_UNSUS_005 | 409 | Unsuspend cannot be applied because the requested item is not eligible for unsuspension in its current state. Please do not retry unless the item's state changes |
| SERV_UNSUS_006 | 429 | Request rate limit exceeded. Retry after the delay indicated in the Retry-After response header (60s) |
| SERV_UNSUS_007 | 500 | The unsuspend request could not be completed due to an unexpected internal error. Please retry with exponential backoff. If the issue continues, contact BHN support and provide the requestId. |
| SERV_UNSUS_008 | 404/207 | This item is missing a required identifier. Provide exactly one of the itemType identifiers and try again. |
| SERV_UNSUS_009 | 404/207 | This item's identifier does not match the required format (3–64 characters, letters, numbers, underscores, and hyphens only). Correct the identifier and resubmit. |
| SERV_UNSUS_010 | 404/207 | This identifier appears more than once in the request. Only the first occurrence was processed — remove the duplicate and resubmit if this item needs a separate action. |
| SERV_UNSUS_011 | 404/207 | No item was found for the identifier provided. Please verify the identifier value and type, then retry the request. |
| SERV_UNSUS_012 | 409/207 | The item is already active and is not currently suspended. Please do not retry unless the item's state changes. |
| SERV_UNSUS_013 | 409/207 | The item is voided and cannot be unsuspended. Please do not retry unless the item state changes. |
| SERV_UNSUS_014 | 409/207 | The identifiers provided for this item do not match our records for the same item. Please verify the identifiers correspond to the same item and resubmit. |
| SERV_UNSUS_015 | 404/207 | More than one eGift is associated with this account. Please resubmit this item using its specific eGiftId. |
| SERV_UNSUS_016 | 404/207 | More than one eGift is associated with this retrievalReferenceNumber. Please resubmit this item using its specific eGiftId or cardReferenceId instead. |
| SERV_UNSUS_017 | 500/207 | This item could not be processed due to an internal error. Retry this item with exponential backoff. If it continues to fail, contact BHN support with the requestId and this item's identifier. |
| SERV_UNSUS_018 | 500/207 | This item could not be processed because of a temporary service issue on our end. Please retry this item individually with exponential backoff. If it continues to fail, contact BHN support with the requestId and this item's identifier." |
| SERV_UNSUS_019 | 413 | The request could not be processed because it contains more items than are allowed in a single request. Please reduce the number of items and resubmit. |
| SERV_UNSUS_020 | 409 | A request with the same requestId is already being processed. Please retry the identical request (same requestId) after a short delay. |
Updated 29 days ago
Did this page help you?