CEcentrobill
Consumer

Block user identifier (email, card, etc.)

Changed on
post/blacklist/block

Request

  • Base URL
    https://api.centrobill.com
  • URL
    https://api.centrobill.com/blacklist/block
  • Auth
    API key in header Authorization

Request body

name'email' | 'card' | 'accountNumber' | 'accountNumberUuid' | 'consumer' | 'ip' | 'phone' | 'device' required

Type of identifier to block

valuestring required

Identifier value (e.g., email). Must match the <b>name</b> parameter type (e.g., if <b>name</b> is 'email', provide an email address here)

blockRelatedItemsboolean

Block all related data associated with the provided identifier under the <b>value</b> parameter

messagestring required

Note or reason for the block

authorstring required

Author of the block request

systemIdstring

Merchant system ID

binstring

Bank Identification Number (for card blocks)

last4string

Last four card digits (for card blocks)

Example request

{
  "name": "email",
  "value": "jonnysonny@example.com",
  "message": "Suspicious activity",
  "author": "admin_user",
  "bin": "411111",
  "last4": "1111"
}

Response

OK

name'email' | 'card' | 'accountNumber' | 'consumer' | 'ip' | 'phone'

Identifier type

valuestring

The actual value of the identifier (e.g., email address)

systemIdinteger

Merchant system ID

blockedboolean

Whether the identifier is currently blocked

messagestring

Note or reason for the block

timestampinteger

Unix timestamp when the block was applied

Example response

{
  "name": "email",
  "value": "jonnysonny@example.com",
  "systemId": 193,
  "blocked": true,
  "message": "Suspicious activity",
  "timestamp": 1746457103
}

Changes

  • 0a3e445a9d65Revision changes
    • breaking

      the request property became not nullable

    • info

      added the new accountNumberUuid enum value to the request property

    • info

      added the new device enum value to the request property

    • info

      request property list-of-types was widened by adding types integer to media type application/json

    • info

      added the non-success response with the status