API Reference

Unsuspend

post
https://api-sandbox.blackhawknetwork.com/v1/servicing/cards/unsuspend

Unsuspends one or more cards, each with a mandatory reason, releasing a previously-applied hold. Error Codes

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Each item requires its own reason, matching the initiating actor.

Unsuspends by eGiftID, retrieval reference number, or card reference - each with its own reason and optional risk context. eGiftID and retrievalReferenceNumber are reserved for internal use only.

string
enum
required

Identifier type for all items in this request. Must be consistent across the array. eGiftId and retrievalReferenceNumber are reserved for internal use only.

Allowed:
items
array of objects
required
length ≥ 1

Items to unsuspend, identified by the type set in itemType.

items*

A single item to unsuspend, with its reason and optional risk context.

string
required
^[A-Za-z0-9_-]{3,64}$

Identifier matching the type declared in itemType.

reason
object
required

The reason this item is being unsuspended.

riskContext
object

Optional risk signal context from the partner's risk engine, applicable to Unsuspend. Only partnerRiskScore is supported today; any unlisted attribute is still accepted.

memo
object

Optional audit memo attached to the servicing operation, capturing context for audit trail purposes.

string
enum
required

Actor that initiated the servicing operation.

Allowed:
Headers
uuid
required

Caller-supplied request identifier (UUID v4), used as the idempotency key for this request — retrying with the same value will not create a duplicate operation. Echoed back in the response.

uuid

Correlation identifier (UUID v4) used to trace this request across systems. Optional — generated by the service if the caller omits it.

Responses

Updated 26 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 26 days ago

Did this page help you?