Skip to main content
Cada cuenta pertenece a un solo cliente. Elígela usando dos dimensiones: quién la gestiona y si es una cartera o una cuenta bancaria. Las operaciones para listar, crear, leer, actualizar y archivar cuentas de cliente están bajo /v3/customers/{customerId}/accounts; las operaciones sobre una cuenta añaden /{accountId}. No existe una búsqueda inversa de accountId a customerId. Guarda el customerId junto a cada accountId para que las solicitudes posteriores puedan dirigirse a la cuenta.

​
Elige una cuenta

issued significa que Swipelux crea y gestiona el recurso. external registra un endpoint propiedad del cliente. Un endpoint de terceros pertenece a un destinatario y destino, no a la lista de cuentas del cliente. Antes de iniciar el recorrido First pay-in del panel de comercio para tarjetas o Apple Pay, crea un monedero Polygon para ese cliente. El recorrido solo ofrece ese monedero Polygon y no puede continuar sin él. Este requisito previo se aplica al recorrido del panel de comercio; las integraciones directas con la API deben usar solo las monedas, redes, métodos y tipos de cuenta devueltos para el cliente y la capacidad actuales.

​
Crea la cuenta

Utiliza POST /v3/customers/{customerId}/accounts. Envía estas cabeceras con uno de los cuerpos de solicitud siguientes:
Utiliza únicamente las monedas, redes, métodos y tipos de cuenta devueltos para el cliente y la capacidad actuales. No copies la disponibilidad de otro cliente o entorno.

​
Espera a que la cuenta sea utilizable

Guarda data.id, data.status y data.openTaskIds de la respuesta de creación. Lee la última cuenta con GET /v3/customers/{customerId}/accounts/{accountId} antes de cotizar una transferencia o mostrar datos bancarios. Utiliza la cuenta solo cuando su estado actual permita la siguiente operación. Si hay IDs de tarea abiertos, complétalos mediante Capacidades y tareas. Una cuenta bancaria emitida puede devolver details: null mientras se aprovisiona. Presenta los datos bancarios solo después de que una lectura actual devuelva el conjunto completo. Si details.referenceRequired es true, muestra el details.reference exacto junto con las coordenadas bancarias.

​
Mantén explícitos los roles de la cuenta

Para un pago, la cartera emitida es el origen en in.accountId. Una cuenta bancaria propiedad del cliente es el destinationId. Para una cuenta bancaria emitida, settlement.accountId es la cartera emitida que recibe los depósitos coincidentes. A continuación, utiliza una cuenta lista en Recibir fondos, Enviar fondos o Emitir una cuenta bancaria.