Saltar al contenido principal
Todos los sistemas operativosNovedadesv1
Iniciar sesión
PATCHhttps://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default

Establecer una tarjeta como predeterminada

Convierte una tarjeta guardada en la tarjeta de pago predeterminada del usuario autenticado o elimina su estado predeterminado.

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado

Encabezados#

2
AuthorizationstringObligatorio
Aceptado o reenviado por el API Gateway para esta operación.
X-Merchant-IDstringOpcional
Aceptado o reenviado por el API Gateway para esta operación.

Parámetros de ruta#

2
user_idstringObligatorio
Valor que sustituye a `user_id` en la ruta del endpoint.
card_idstringObligatorio
Valor que sustituye a `card_id` en la ruta del endpoint.

Cuerpo de la solicitud#

1
is_defaultbooleanOpcional
Payload JSON aceptado por el servicio responsable. Usa el panel de solicitud para editarlo y previsualizarlo.
Ejemplo true

Respuesta#

4
200La solicitud se aceptó o completó. Revisa el payload para conocer el resultado de negocio.
401Las credenciales o el contexto del llamador no son válidos.
403Las credenciales o el contexto del llamador no son válidos.
404No se encontró el recurso o la ruta solicitada.

Comportamiento de la tarjeta predeterminada#

enviar {"is_default": true} para convertir la tarjeta guardada seleccionada en la predeterminada del usuario. DEUNA elimina el estado predeterminado de cualquier otra tarjeta del mismo usuario, de modo que solo haya una tarjeta predeterminada como máximo.

El cuerpo de la solicitud es opcional. Omitirlo tiene el mismo efecto que enviar {"is_default": true}. enviar {"is_default": false} para eliminar el estado predeterminado de la tarjeta seleccionada sin modificar ninguna otra tarjeta.

Antes de llamar al endpoint#

  • Autentica al cliente y envía su token de acceso de usuario en el Authorization header.
  • Configura user_id con el UUID del usuario autenticado.
  • Usa un card_id devuelto por Enumerar tarjetas almacenadas. La tarjeta debe pertenecer al usuario autenticado.

Verifica el resultado#

Una solicitud correcta devuelve 200 OK con la tarjeta actualizada. Confirma que su campo is_default coincida con el valor solicitado. También puedes enumerar las tarjetas guardadas del usuario y verificar que ninguna otra esté marcada como predeterminada.

El endpoint devuelve 404 Not Found cuando la tarjeta seleccionada no existe para el usuario autenticado. Corrige los UUID no válidos o el JSON mal formado antes de volver a intentarlo; las solicitudes repetidas con el mismo is_default dejan la tarjeta en el mismo estado.