Cancel Card

Permanently cancels a card, preventing its future use. Ideal for cases of loss, theft, or card obsolescence.

Example of requisition:

{
  "Method": "CancelCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "Pin": "MTIzNA=="
}

{
  "Success": "true",
  "Message": "Sua solicitação de cancelamento foi salva com sucesso. O processo levará alguns minutos para ser concluído."
}

Field Descripition:

📘

Important:

How the CancelCard Method Works:

1. Eligibility for Cancellation:

• The card cannot have a CardStatus of:
  • PreCreated = 10
  • Canceled = 11

2. Allowed Card Status for Cancellation:

• The following CardStatus values are valid for initiating the cancellation process:
  • Active = 4
  • Generated = 2
  • CancellationError = 13
  • Bound = 3
  • Binding = 8
  • ErrorBinding = 5

3. Special Condition for Active Cards:

• If the card has a CardStatus of Active = 4 and a UsageType of Balance (Balance Control by Payment), the process cannot proceed if the card balance is greater than zero.

Inactivate And Reissue Card

Deactivates an existing card and issues a replacement, preserving the balance and associated information.

📘

Important:

• The new "IdentifierCard" generated during reissue must be used in the ActivateCard and ChangePinCard flow. This applies to both nominal and non-nominal cards.
• To use this method, the customer must provide the current card password (PIN).

Example of requisition:

{
  "Method": "InactivateAndReissueCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "IdentifierProduct": "FC0000001",
  "Pin": "MTIzNA==",
  "ReasonCode": "4",
  "CardDeliveryAddress": {
    "Line": "Av José Bastos",
    "Number": "4140",
    "Complement": "AP 303",
    "Reference": "Ao lado da JM Veículos",
    "Neighborhood": "Rodolfo Teófilo",
    "ZipCode": "60431086",
    "City": "Fortaleza",
    "State": "CE",
    "Country": "Brasil"
  }
}

{
  "Success": "true",
  "Card": "800015485",
  "Message": "Solicitação de reemisão de cartão registrada com sucesso!"
}

Field Descripition:

Change Pin Card

Enables the security PIN of a card to be changed, enhancing protection against unauthorized access.

📘

Important:

The current PIN is required to make the change.

Example of requisition:

{
  "Method": "ChangePinCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "CurrentPin": "NDAyNw==",
  "Pin": "MTIzNA==",
  "PinCheck": "MTIzNA=="
}

{
  "Success": "true",
  "Message": "Solicitação de alteração de senha registrada com sucesso!"
}

Field Descripition:

Reset Pin Card

Resets a card's PIN to its default setting, allowing the cardholder to set a new code.

📘

Importante:

The current PIN is not required to perform the reset.

Example of requisition:

{
  "Method": "ResetPinCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "DateOfBirth": "1992/20/02"
}

{
  "Success": "true",
  "Message": "Solicitação de alteração de senha registrada com sucesso!"
}

Field Descripition:

Block Card

Temporarily blocks a card, preventing its use until it is unblocked. Ideal for security purposes.

Example of requisition:

{
  "Method": "BlockCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "Pin": "MTIzNA==",
  "ReasonCode": "4"
}

{
  "Success": "true",
  "Message": "Solicitação de bloqueio registrada com sucesso!"
}

Field Descripition:

Unblock Card

Unblocks a previously blocked card, restoring its normal functionality.

📘

Important:

This method can only be used if reason code 8 is provided in the BlockCard method.

Example of requisition:

{
  "Method": "UnblockCard",
  "PartnerId": 30326,
  "BusinessUnitId": 30326,
  "IdentifierCard": "800015485",
  "Pin": "MTIzNA=="
}

{
  "Success": "true",
  "Message": "Solicitação de desbloqueio registrada com sucesso!"
}

Field Descripition: