Saltar al contenido principal
Guarda una dirección de facturación para la emisión de tarjetas virtuales en la cuenta del solicitante. La dirección se guarda como una dirección de usuario BILLING y luego se puede pasar a createVirtualCard como userAddressId. Cuando se proporciona authUserId, la dirección se guarda para el usuario subyacente de ese usuario autorizado, mientras permanece vinculada a la cuenta del solicitante. El authUserId debe ser una asignación de usuario autorizado ACTIVA y no propietario en la cuenta del solicitante. Si ya existe una dirección de facturación idéntica para el titular de la tarjeta objetivo en la cuenta del solicitante, se devuelve la dirección existente en lugar de crear un duplicado. La coincidencia se realiza en los campos de la dirección, la cuenta, el usuario objetivo y el tipo BILLING.
Requisitos previos: un token Bearer con el alcance CREATE_VIRTUALCARD.
La dirección de facturación debe ser verificableEsta mutación almacena la dirección de facturación. Debe ser una dirección de EE. UU. real y entregable (US, USA o United States) con ciudad, estado y código ZIP correctos, y no se aceptan apartados postales (PO boxes). La verificación de USPS/Smarty se ejecuta cuando se crea una tarjeta virtual: una dirección que no se puede verificar allí hace que la creación de la tarjeta falle con VC-0025. Consulta Requisitos de formato de direcciones para conocer todas las reglas de los campos y ejemplos.

​
Cómo encaja todo

  1. Guarda una dirección con addVirtualCardAddress; recibirás un userAddressId.
  2. Pasa ese userAddressId a createVirtualCard. Tiene prioridad sobre cualquier billingAddress en línea.
  3. Reutiliza el mismo userAddressId en tantas tarjetas como desees: la dirección se almacena una vez en la cuenta.
También puedes omitir el preguardado por completo y pasar un objeto billingAddress en línea en createVirtualCard; se reutilizará una dirección guardada que coincida o se creará una nueva.

​
Próximos pasos

Agregar dirección de tarjeta virtual

El contrato completo de la mutación: parámetros, respuestas, ejemplos y códigos de error.

Crear una tarjeta virtual

Pon a trabajar el userAddressId guardado para emitir una tarjeta.