PIpismo
Bulletin

Delete card from Protection Bulletin

Remove a Pismo-issued card from the Protection Bulletin.

Note: This endpoint takes an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

delete/v1/bulletin/{card_id}

Request

  • Base URL
    https://sandbox.pismolabs.io/protection-bulletin
  • URL
    https://sandbox.pismolabs.io/protection-bulletin/v1/bulletin/{card_id}
  • Auth
    HTTP bearer

Path parameters

card_idnumber required

Pismo card ID.

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Response

Created

card_idnumber

Pismo card ID.

org_idstring

Pismo organization/tenant ID.

program_idnumber

Pismo program ID.

network_brand_type'ELO' | 'MASTERCARD' | 'VISA'

Card network brand.

created_atstring yyyy-mm-dd hh:mm:ss

Date and time when the Protection Bulletin registration was created. Format = ISO 8601.

updated_atstring yyyy-mm-dd hh:mm:ss

Date and time when the Protection Bulletin was updated. Format = ISO 8601.

network_track_numberstring

Created in the internal system to track the card's event history. This is a combination between the tenant and the truncated random uuid.

state'' | 'BLOCKED' | 'UNBLOCKED'

Is card blocked or not in the network brand? When the state is empty, it means the network brand did not successfully receive any action.

status'PENDING' | 'SUCCESS' | 'FAILED'

Request processing status.

purge_datestring yyyy-mm-dd

Date when the card will be removed from the Protection Bulletin in the network brand. Format = yyyy-mm-dd.

was_automatically_purgedboolean

Was card removed from the network brand on the purge date?

card_track_numbernumber

Pismo card track number.

region_codestring[]

Region code contains one or more Account Screen Authorization File (ASAF) region codes that define the distribution of a Visa cardholder account number in Card Recovery Bulletin Service files. REQUIRED for Visa. <br /> 0 - No Bulletin / V.I.P. Only (cannot be combined with other region codes)<br /> A - All Asia-Pacific region countries<br /> B - All Central Europe, Middle East, and Africa (CEMEA) region countries.<br /> C - All Visa Canada<br /> D - National Card Recovery Bulletin<br /> E - All European countries<br /> F - All Latin America and Caribbean (LAC) region countries <br />

Region codes can be in any order, except no other region code can be specified in combination with region code 0.

Visa documentation: VisaNet Authorization-Only Online Messages – Technical Specifications - Table 215: Field 127E.2 Account Screen Authorization File (ASAF) Region Codes

Example response

{
  "card_id": 10203040,
  "org_id": "TN-123XXX-XXXXXX-XXXXXXX",
  "program_id": 1010,
  "network_brand_type": "ELO",
  "created_at": "2025-04-22 20:31:50",
  "updated_at": "2025-04-22 20:31:50",
  "network_track_number": "TN-123XXX-XXXXXX-XXXXXXX::1a2b3c",
  "state": "BLOCKED",
  "status": "PENDING",
  "purge_date": "2025-04-22",
  "was_automatically_purged": true,
  "card_track_number": 1,
  "histories": [
    {
      "event": "POST",
      "event_date": "2025-04-22 20:31:50",
      "status": "PENDING",
      "reason": "L",
      "network_track_number": "TN-123XXX-XXXXXX-XXXXXXX::1a2b3c",
      "was_automatically_purged": true,
      "card_track_number": 1,
      "network_response_data": "{\"status\":\"SUCCESS\",\"message\":\"Card added to Protection Bulletin\"}"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.