Saltar al contenido principal
PATCH
/
api
/
v1
/
cards-program
/
cards
/
:cardId
/
status
curl --location --request PATCH 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/cards/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d/status' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data-raw '{
    "status": "locked"
}'

{
  "success": true,
  "cardId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
  "status": "locked"
}

​
Parámetros

​
cardId
string
requerido
El identificador único de la tarjeta

​
Cuerpo

​
status
string
requerido
Estado deseado de la tarjeta: active (desbloquear) o locked

​
Respuesta

​
success
boolean
Indica si la operación fue exitosa
​
cardId
string
El identificador único de la tarjeta
​
status
string
Estado actualizado de la tarjeta
curl --location --request PATCH 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/cards/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d/status' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data-raw '{
    "status": "locked"
}'

{
  "success": true,
  "cardId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
  "status": "locked"
}

​
Respuestas de error

{
  "success": false,
  "error": "Unauthorized. Please check your authentication credentials."
}

​
Casos de uso

Bloquear una tarjeta es útil cuando:
  • El titular reporta la tarjeta como perdida o robada
  • Se detecta actividad sospechosa
  • El titular quiere desactivar la tarjeta temporalmente
Desbloquear una tarjeta restaura su funcionamiento normal después de haber sido bloqueada.