Cuentas y carteras

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.

Elige una cuenta

Cuenta	Úsala para
Cartera emitida	Mantener un saldo de stablecoin en custodia, financiar un pago, recibir un cobro o liquidar una cuenta bancaria emitida.
Cuenta bancaria emitida	Ofrecer al cliente datos bancarios reutilizables que se liquidan en una cartera emitida.
Cartera externa	Registrar una dirección de blockchain propiedad del cliente.
Cuenta bancaria externa	Registrar una cuenta bancaria propiedad del cliente para un pago propio.

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.

Crea la cuenta

Utiliza POST /v3/customers/{customerId}/accounts. Envía estas cabeceras con uno de los cuerpos de solicitud siguientes:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: account-create-001
Content-Type: application/json

Cartera emitida
Cuenta bancaria emitida
Cartera externa
Cuenta bancaria externa

{
  "origin": "issued",
  "type": "wallet",
  "currency": "USDC",
  "network": "base",
  "label": "Settlement wallet"
}

{
  "origin": "issued",
  "type": "bank",
  "method": "ach",
  "country": "US",
  "currency": "USD",
  "settlement": {
    "accountId": "${SETTLEMENT_WALLET_ID}"
  },
  "label": "USD account"
}

{
  "origin": "external",
  "type": "wallet",
  "currency": "USDC",
  "network": "polygon",
  "details": {
    "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
  },
  "label": "Customer Polygon wallet"
}

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

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.

Comienza

Incorpora clientes

Crea flujos de dinero

Lanzamiento

Cuentas y carteras

Elige una cuenta

Crea la cuenta

Espera a que la cuenta sea utilizable

Mantén explícitos los roles de la cuenta

​Elige una cuenta

​Crea la cuenta

​Espera a que la cuenta sea utilizable

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

Elige una cuenta

Crea la cuenta

Espera a que la cuenta sea utilizable

Mantén explícitos los roles de la cuenta