Endpoints de cuenta

Listar aliases

Devuelve todas las cuentas con alias activo del collector asociado a la API key. El worker pagina internamente y filtra solo registros con alias presente y no eliminados.

GET/api/v2/accounts/aliasesEndpoint público

Endpoint

No recibe parámetros de query.

GET/api/v2/accounts/aliases

Útil para soporte, conciliación o validaciones previas sobre aliases ya emitidos por el collector.

Contrato

Cada item representa una cuenta de cobro con alias activo.

Campo	Tipo	Notas
account_number	string	Número de cuenta asociado al alias.
customer_id	string	Identificador del cliente/cuenta en el banco.
alias	string	Alias activo expuesto al comprador.

Cómo funciona

La ruta usa las tus credenciales de cobro de la empresa, llama al listado de cuentas del collector y devuelve solo las que cumplen alias != null y deleted = "no".

Ejemplos

Snippets backend para listar aliases activos.

curl -G "https://transferfix.com.ar/api/v2/accounts/aliases" \
  -H "X-API-Key: ck_live_12345678_abcd"

Respuesta

El contrato real del worker sigue el formato success + data del resto de la API.

Respuesta 200

{
  "success": true,
  "data": {
    "accounts": [
      {
        "account_number": "0000277800000000560470",
        "customer_id": "pianta.demo.0002",
        "alias": "pianta.demo.0002"
      },
      {
        "account_number": "0000277800000000560471",
        "customer_id": "pianta.demo.0001",
        "alias": "pianta.demo.0001"
      }
    ]
  }
}

Importante

Si preferís pensar el resultado como una lista simple, la colección útil es accounts. En el payload real del worker esa lista vive dentro de data.accounts.