Saltar al contenido principal
POST
Registrar tarjetas guardadas para Account Updater
Registra un lote de tarjetas ya almacenadas en Card Account Updater, para que sus datos se mantengan actualizados automáticamente. Envía los ids de los métodos de pago (el vaulted_token recibido al inscribir cada tarjeta) en una sola solicitud.
Cómo funciona el registro
  • Puedes registrar entre 1 y 100 tarjetas por solicitud; cada id debe ser un vaulted_token válido.
  • La validación es todo o nada: si algún id no es válido, se rechaza toda la solicitud.
  • El registro se ejecuta de forma asíncrona. Una respuesta 200 con accepted confirma que las tarjetas fueron aceptadas, no que la actualización ya se haya realizado; las actualizaciones se notifican más tarde mediante el webhook de inscripción.
  • Card Account Updater se habilita por organización. Si tu organización no está inscrita, la solicitud devuelve 400 con code: BAD_REQUEST y el mensaje organization is not enrolled in account updater.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido
X-Idempotency-Key
string
header
predeterminado:<Your X-Idempotency-Key>
requerido

Cuerpo

application/json
payment_method_ids
string<uuid>[]
requerido

Lista de ids de métodos de pago guardados (vaulted_token) para registrar en Card Account Updater. Entre 1 y 100 elementos; cada uno debe ser un UUID válido.

Required array length: 1 - 100 elements

Respuesta

200

accepted
integer

Número de tarjetas aceptadas para el registro en Card Account Updater.

Ejemplo:

2