Descripción general de edición de tarjeta

La mutación editVirtualCard te permite actualizar varios detalles de una tarjeta virtual existente, como límites de gasto, fecha de bloqueo y apodo.

Requisitos previos: un token de acceso de usuario con el alcance EDIT_VIRTUALCARD, y el virtualCardId de la tarjeta a actualizar.

Argumentos

input (EditVirtualCardInput!): El objeto de entrada que contiene el ID de la tarjeta virtual y los campos a actualizar.

Campos de EditVirtualCardInput

Field	Type	Description	Required
`virtualCardId`	`UUID!`	La tarjeta virtual a actualizar.	Yes
`spendLimit`	`Float`	El monto máximo que puedes cargar a la tarjeta.	No
`spendLimitDuration`	`VirtualCardSpendLimitDuration`	Tipo de duración del límite de la tarjeta.	No
`lockDate`	`String`	La fecha en que la tarjeta será bloqueada. Formato: yyyy-mm-dd	No
`lockCardNextUse`	`Boolean`	La configuración para bloquear la tarjeta después del próximo uso.	No
`cardNickname`	`String`	El apodo de la tarjeta.	No
`primaryFundingSource`	`VirtualCardFundingSource`	Fuente de fondos principal para la tarjeta virtual.	No
`bankAccountId`	`UUID`	El identificador único de la cuenta bancaria.	No
`userCashBalanceId`	`UUID`	El identificador único del saldo en efectivo del usuario.	No

Ejemplo cURL

curl -X POST \
  https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_USER_ACCESS_TOKEN' \
  -d '{
    "query": "mutation { editVirtualCard( input: { virtualCardId: \"07df5653-43a8-4532-9881-3ab5857bbe11\", spendLimit: 200.00, spendLimitDuration: \"MONTHLY\", cardNickname: \"Edited Card Nickname\", lockCardNextUse: false } ) { virtualCardId cardholderName expiryMonth expiryYear virtualCardLast4 status cardType initialAmount usedAmount createdAt authorizationSetting { virtualCardAsaSettingsId lockDate dailySpendLimit monthlySpendLimit cardNickname lockCardNextUse } } }"
  }'

Respuesta de ejemplo

{
  "data": {
    "editVirtualCard": {
      "virtualCardId": "07df5653-43a8-4532-9881-3ab5857bbe11",
      "userId": "00a2ec0a-255f-4fe7-85ad-2958dc8d3c72",
      "cardholderName": "John Doe",
      "expiryMonth": "12",
      "expiryYear": "27",
      "virtualCardLast4": "7890",
      "status": "ACTIVE",
      "cardType": "MULTI_USE",
      "initialAmount": 200,
      "usedAmount": 0,
      "createdAt": "2023-10-26T10:00:00Z",
      "authorizationSetting": {
        "virtualCardAsaSettingsId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "lockDate": "1875743999999",
        "dailySpendLimit": null,
        "monthlySpendLimit": "200.00",
        "cardNickname": "Edited Card Nickname",
        "lockCardNextUse": false
      }
    }
  }
}

Campos de la respuesta

Field	Type	Description
`virtualCardId`	`UUID`	El identificador único de la tarjeta virtual que fue editada.
`cardholderName`	`String`	El nombre del titular asociado con la tarjeta virtual.
`expiryMonth`	`String`	El mes de vencimiento de la tarjeta virtual.
`expiryYear`	`String`	El año de vencimiento de la tarjeta virtual.
`virtualCardLast4`	`String`	Los últimos cuatro dígitos del número de la tarjeta virtual.
`status`	`VirtualCardStatus`	El estado actual de la tarjeta virtual.
`cardType`	`VirtualCardType`	El tipo de la tarjeta virtual (por ejemplo, `MULTI_USE`).
`initialAmount`	`Float`	El monto inicial (límite de gasto) establecido en la tarjeta cuando fue creada.
`usedAmount`	`Float`	El monto total gastado en la tarjeta virtual.
`createdAt`	`DateTime`	La marca de tiempo cuando la tarjeta virtual fue creada originalmente.
`authorizationSetting`	`VirtualCardAuthorizationSetting`	Un objeto que contiene la configuración de autorización de la tarjeta virtual, reflejando cualquier actualización.
`authorizationSetting.virtualCardAsaSettingsId`	`UUID`	El identificador único para esta configuración de autorización específica.
`authorizationSetting.lockDate`	`String`	La fecha en que la tarjeta será bloqueada, si está configurada.
`authorizationSetting.dailySpendLimit`	`String`	El límite de gasto diario, si aplica.
`authorizationSetting.monthlySpendLimit`	`String`	El límite de gasto mensual, si aplica.
`authorizationSetting.cardNickname`	`String`	El apodo actualizado de la tarjeta.
`authorizationSetting.lockCardNextUse`	`Boolean`	Indica si la tarjeta será bloqueada después de su próximo uso.

Próximos pasos

Bloquear una tarjeta virtual

Bloquea temporalmente todo el gasto en una tarjeta sin cerrarla.

Desbloquear una tarjeta virtual

Vuelve a habilitar una tarjeta bloqueada para que las autorizaciones vuelvan a tener éxito.

​Argumentos

​Campos de EditVirtualCardInput

​Ejemplo cURL

​Respuesta de ejemplo

​Campos de la respuesta

​Próximos pasos

Bloquear una tarjeta virtual

Desbloquear una tarjeta virtual

Argumentos

Campos de EditVirtualCardInput

Ejemplo cURL

Respuesta de ejemplo

Campos de la respuesta

Próximos pasos